画像から3Dモデル
提供中画像やプロンプトを入れると、テクスチャ付き3Dモデルが出てきます。GLB、FBX、サムネイル付き。リグに対応したキャラクターも、小物も作れます。
画像から3Dモデル
入力
prompt作りたいものの説明。kindcharacter または prop。武器、帽子、家具などの物。リグなし。quality標準または高精細。engine使う3Dエンジン(複数あるときだけ送信)。標準3D × 小物標準3D × 小物
3Dパイプラインのしくみ
自社ゲームのキャラクター作りに使っているのと同じ手順です。
- 01Tポーズのチェック画像をすばやく確認します。無地の背景で口を閉じた無表情の、厳密な正面Tポーズでなければ、同じキャラクターのまま描き直します。腕を広げると手がきれいに仕上がります。
- 023DモデルTポーズ画像から作る、テクスチャ付きでゲームにそのまま使えるメッシュ。PBRマテリアルで、焼き込まれたライティングは除去。キャラクターと小物でそれぞれ三角形の上限があります。
- 03リグキャラクターが動けるように骨格を合わせます。希望すれば歩き・走りのクリップも。ゲームエンジン向けのFBXとWeb向けのGLBが届きます。
3つのステップを1回の呼び出しで:3Dキャラクター
コードから 画像から3Dモデル を呼び出す
3Dツールはそれぞれ独立したエンドポイントです。呼び出すとタスクが返るので、完了まで確認してください。失敗した実行は課金されません。
https:/ / api.opennan.com/ v1/ 3d/ models- POST
/画像やプロンプトからリグ付きキャラクターへ。v1/ 3d/ characters - POST
/どんなキャラクター画像も正面Tポーズに。v1/ 3d/ tpose - POST
/人型モデルからリグ付きFBXとGLBへ。v1/ 3d/ rig - GET
/進捗と出力ファイル。v1/ tasks/ {id} - GET
/3Dエンジンと品質ランク、価格付きv1/ models? category= 3d
API キーを取得
コンソールでキーを作成します。プレイグラウンドと同じ残高を使います。
キーを作成最初のリクエストを送る
プレイグラウンドが送るのと同じリクエストです。OPENNAN_KEY にキーを設定してください。
curl https://api.opennan.com/v1/3d/models \ -H "Authorization: Bearer $OPENNAN_KEY" \ -H "Content-Type: application/json" \ -d '{"prompt":"a wooden treasure chest with gold trim","kind":"prop","quality":"standard","engine":"opennan-3d-studio"}' # Then poll until "status" is "succeeded" or "failed": curl https://api.opennan.com/v1/tasks/<task id> -H "Authorization: Bearer $OPENNAN_KEY"タスクを確認する
呼び出すとすぐにタスク ID が返ります。終わるまでタスクを確認します:
GEThttps:// api.opennan.com/ v1/ tasks/ {id} - queued
- ワーカーの空き待ち
- running
- 生成中
- succeeded
- 完了: outputs[].url にファイルがあります
- failed
- 失敗: 料金はかかりません
エラーと直し方
401キーがない、または間違っている
コンソールで作ったキーを Authorization: Bearer ヘッダーで送ってください。
402残高不足
請求ページで残高を追加し、同じ呼び出しをもう一度送ってください。
400受け付けられない値がある
error.message にフィールド名が出ます。パラメーター表の値を使ってください。
429リクエストが多すぎる
数秒待ってから再試行し、429 が続くたびに待ち時間を延ばしてください。
AI アプリに Opennan を追加
一度の設定で、AI が Opennan のすべてのツールを使えます:動画、画像、チャット、音声、音楽、効果音、3D、字幕、吹き替え。お使いのアプリを選んで手順に従ってください。
https:/ / api.opennan.com/ v1/ mcpCodex CLI、Codex アプリ、Codex の IDE 拡張で使えます(共通の ~/.codex/config.toml)。アプリや IDE が OPENNAN_KEY を読めない場合は、キーを書いた config.toml の方法を使ってください。Codex はツールを呼ぶ前に確認するので、承認して続けます。
キーを OPENNAN_KEY として保存
# macOS / Linux (zsh shown; bash: ~/.bashrc) echo 'export OPENNAN_KEY="sk-..."' >> ~/.zshrc source ~/.zshrc # Windows (PowerShell), then open a new terminal setx OPENNAN_KEY "sk-..."Opennan プラグインをインストール:サーバーと、モデル選び・価格確認・結果待ちを AI に教えるスキルが入ります
codex plugin marketplace add Opennan/opennan-ai-plugin codex plugin add opennan@opennanまたはサーバーだけを追加
codex mcp add opennan --url https://api.opennan.com/v1/mcp --bearer-token-env-var OPENNAN_KEYまたは ~/.codex/config.toml にこれを追加
[mcp_servers.opennan] url = "https://api.opennan.com/v1/mcp" http_headers = { Authorization = "Bearer sk-..." }opennan が一覧にあるか確認
codex mcp listCodex を再起動して、何でも頼んでください
“ネオン街に降る雨の 5 秒動画と、それに合う曲とポスター画像を作って。”
sk-... をご自身のキーに置き換え、他人に見せないでください。キーを持つ人は残高を使えます。キーがなくてもツール一覧は表示できますが、生成にはキーが必要です。
AI エージェントから使う
エージェントに Opennan の MCP サーバーを追加して、このツールを呼び出します。
- ツール
- generate_3d_model
- 引数の例
{ "prompt": "a wooden treasure chest with gold trim", "kind": "prop", "quality": "standard", "engine": "opennan-3d-studio" }
画像から3Dモデル: よくある質問
画像から3Dモデル の料金は?
実行ごとの支払いで、開始前に表示される料金です。
コードから呼び出すには?
API キーを付けて POST https://api.opennan.com/v1/3d/models を送ります。タスク ID が返るので、成功か失敗になるまで https://api.opennan.com/v1/tasks/{id} を確認します。
AI エージェントから使えますか?
はい。MCP サーバー https://api.opennan.com/v1/mcp を追加して generate_3d_model ツールを呼び出すか、エージェントに https://api.opennan.com/llms.txt を読ませてください。
実行が失敗したら?
失敗した実行には料金がかかりません。支払いは結果に対してだけです。
なぜ画像はTポーズである必要があるの?
腕をまっすぐ広げると手が体から離れるので、モデルの手がきれいになり、リグも正しい関節で曲がります。腕を下ろした姿勢やAポーズだと手が服と一体化しやすく、笑顔がテクスチャに描き込まれてしまいます。そのため、Tポーズでない画像は同じキャラクターのまま先に描き直します。
どんなファイルが届きますか?
Web、ゲームエンジン、3Dアプリ向けのGLB、Roblox Studio、Unity、Unreal、Blender向けのFBX、そしてサムネイル。リグ付きの実行では歩き・走りのクリップも付きます。