自動リグ
提供中人型モデルに骨格を追加して動かせるようにします。リグ付きのFBXとGLB、歩き・走りのクリップを受け取れます。
自動リグ
入力
model_urlリグを付けるGLBへの公開httpsリンク。当社の3Dモデルツールで作ったFBXでも構いません。animationsリグ付きモデル用に作るアニメーションクリップ。追加料金なし3Dパイプラインのしくみ
自社ゲームのキャラクター作りに使っているのと同じ手順です。
- 01Tポーズのチェック画像をすばやく確認します。無地の背景で口を閉じた無表情の、厳密な正面Tポーズでなければ、同じキャラクターのまま描き直します。腕を広げると手がきれいに仕上がります。
- 023DモデルTポーズ画像から作る、テクスチャ付きでゲームにそのまま使えるメッシュ。PBRマテリアルで、焼き込まれたライティングは除去。キャラクターと小物でそれぞれ三角形の上限があります。
- 03リグキャラクターが動けるように骨格を合わせます。希望すれば歩き・走りのクリップも。ゲームエンジン向けのFBXとWeb向けのGLBが届きます。
3つのステップを1回の呼び出しで:3Dキャラクター
コードから 自動リグ を呼び出す
3Dツールはそれぞれ独立したエンドポイントです。呼び出すとタスクが返るので、完了まで確認してください。失敗した実行は課金されません。
https:/ / api.opennan.com/ v1/ 3d/ rig- POST
/画像やプロンプトからリグ付きキャラクターへ。v1/ 3d/ characters - POST
/どんなキャラクター画像も正面Tポーズに。v1/ 3d/ tpose - POST
/画像やプロンプトからテクスチャ付きモデルへ。v1/ 3d/ models - GET
/進捗と出力ファイル。v1/ tasks/ {id} - GET
/3Dエンジンと品質ランク、価格付きv1/ models? category= 3d
API キーを取得
コンソールでキーを作成します。プレイグラウンドと同じ残高を使います。
キーを作成最初のリクエストを送る
プレイグラウンドが送るのと同じリクエストです。OPENNAN_KEY にキーを設定してください。
curl https://api.opennan.com/v1/3d/rig \ -H "Authorization: Bearer $OPENNAN_KEY" \ -H "Content-Type: application/json" \ -d '{"model_url":"https://example.com/character.glb","animations":true}' # 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 サーバーを追加して、このツールを呼び出します。
- ツール
- rig_3d_model
- 引数の例
{ "model_url": "https://example.com/character.glb", "animations": true }
自動リグ: よくある質問
自動リグ の料金は?
実行ごとの支払いで、開始前に表示される料金です。
コードから呼び出すには?
API キーを付けて POST https://api.opennan.com/v1/3d/rig を送ります。タスク ID が返るので、成功か失敗になるまで https://api.opennan.com/v1/tasks/{id} を確認します。
AI エージェントから使えますか?
はい。MCP サーバー https://api.opennan.com/v1/mcp を追加して rig_3d_model ツールを呼び出すか、エージェントに https://api.opennan.com/llms.txt を読ませてください。
実行が失敗したら?
失敗した実行には料金がかかりません。支払いは結果に対してだけです。
なぜ画像はTポーズである必要があるの?
腕をまっすぐ広げると手が体から離れるので、モデルの手がきれいになり、リグも正しい関節で曲がります。腕を下ろした姿勢やAポーズだと手が服と一体化しやすく、笑顔がテクスチャに描き込まれてしまいます。そのため、Tポーズでない画像は同じキャラクターのまま先に描き直します。
どんなファイルが届きますか?
Web、ゲームエンジン、3Dアプリ向けのGLB、Roblox Studio、Unity、Unreal、Blender向けのFBX、そしてサムネイル。リグ付きの実行では歩き・走りのクリップも付きます。