Tripo3Dモデル、Blenderで仕上げる
Tripo3Dは、画像またはプロンプトを約1分でテクスチャ付きメッシュに変換します。 各実行にはクレジットがかかり、制御は大まかで、新しいモデルバージョンでは同じリクエストに対して異なるメッシュが生成されます。Blenderは無料で正確であり、スクリプトを使用すれば毎回同じ結果が得られます。そのため、Tripo3Dからベースメッシュを一度取得し、それを保持して、すべての微調整をBlenderで行います。形状が間違っている場合のみ、新しい実行に料金を支払います。サイズ、向き、凹凸のある手、テクスチャの色合い、三角形の予算はすべてBlenderで修正できます。
2026-11-20にtripo-cli 0.11.2、Blender 5.3.0、Node 24でmacOS上でテスト済み。tripo --versionが新しいバージョンを表示する場合は、このファイルのフラグよりもtripo docs --topic commands/makeを信頼してください。
参照ファイル
このファイルは、セットアップから完成したGLBまで、1つのモデルを処理します。タスクにその詳細が必要な場合にのみ、参照ファイルを開いてください。
| 参照ファイル | 開くタイミング | 行数 |
|---|---|---|
| setup | インストールまたはサインイン中、MCPサーバーの追加中、Linuxでの作業中、または別のTripoルートを検討している場合 | 146 |
| pictures | ターゲット画像に一致する必要があるモデルの入力画像を作成し、レビューを依頼する場合 | 123 |
| generation | モデルやパラメータの選択、複数の画像の使用、Tripo自身のステップの連鎖、クレジットの計算を行う場合 | 146 |
| blender | 生成されたモデルの修正、ライブBlenderでの作業、またはこれらの手順をプロジェクトのビルドに組み込む場合 | 283 |
| errors | 失敗したコマンドの終了コード、またはBlenderスクリプトエラーを読み取る場合 | 43 |
このファイルが実行する2つのスクリプトは、その隣のtools/にあります。以下では、<skill-dir>はこのSKILL.mdが入っているフォルダを意味します。
1. 人間が最初に行うべきこと
エージェントはこれらを実行できません。何かを実行する前に、これらを依頼してください。
-
有料のTripo3D APIアカウント。 https://developers.tripo3d.ai(国際版)またはhttps://developers.tripo3d.com(中国本土)で取得します。APIクレジットはTripo Studioクレジットとは別です。有料であることは権利に関わります。Tripoの利用規約では、有料ユーザーは出力結果に対する権利(公開や販売を含む)を取得します(セクション5.2.2)。無料ユーザーの出力結果はTripoが保持します(セクション5.2.1)。
-
システムのシークレットストアにあるAPIキー。macOSでは、人間が以下を実行してプロンプトでキーを入力します。これにより、キーがチャットを通過することはありません。
security add-generic-password -a "$USER" -s tripo3d-api-key -wキーがない場合は、setupのブラウザサインインも機能します。
-
Blender 5.x。パスに
blenderが通っている必要があります。ライブコントロールには、オンラインアクセスを許可が有効なBlender Lab MCPアドオンも必要です。blenderを参照してください。
チャットでキーを要求したり、作成するファイルにキーを書き込んだりしないでください。セクション2のように、シークレットストアからインラインで読み取ってください。
2. Tripo3Dのセットアップ
マシンごとに1回:
node --version # 20以降が必要
npm install -g tripo-cli # `tripo`コマンドをインストール
tripo login --key "$(security find-generic-password -s tripo3d-api-key -w)" \
2>&1 | sed -E 's/tsk_[A-Za-z0-9_-]+/tsk_<hidden>/g'
tripo doctor # すべてのチェックが "ok": true
tripo login --keyは両方のリージョンを試し、キーを受け入れた方を保持して~/.tripo/config.jsonにモード0600で保存するため、後続のコマンドでキーは必要ありません。tripo doctorでの残高0は警告であり、失敗ではありません。
Tripo3Dの呼び出しには、Tripoの公式ツールであるtripo-cliを常に使用してください。古いTripo-Developer/tripo-mcpサーバーは起動時にクラッシュし、もはや存在しないBlenderアドオンを駆動します。BlenderのTripo Bridgeアドオンは、人物がTripo Webサイトから送信したモデルしか受け付けません。setupに詳細があります。
3. ベースモデルの生成
入力を選択します。 被写体全体が1つだけ、無地の背景に、正面または斜め前からのビューで写っている画像。2~4枚の画像で隠れた側面をカバーします。ファイル名はfront、left、back、rightとしてください。モデルは画像の形状、表面、色をコピーするため、摩耗、苔、色は画像内に含まれている必要があります。引用符で囲まれたプロンプトも機能しますが、制御は弱くなります。
支払う前に画像をレビューしてもらいます。 画像の欠陥はメッシュにそのまま反映され、新しい実行には再びクレジットがかかります。人間がコンセプトアートや写真などのターゲットを指定し、モデルをそれに一致させたい場合:
- ターゲットのみからチェックリストを作成します。各パーツの表示内容、失敗している点、測定可能な比率や色など。
- 各ビューにつき2~8枚の新しい候補を作成します。最初に正面、合格した正面から他のビューを作成します。
- ターゲット、チェックリスト、候補を、それらを作成していない別のレビュー担当者(別のエージェントまたは人間)に渡します。レビュー担当者の仕事はそれらを不合格にすることです。
- 合格した画像に対してのみTripo3Dを実行し、レビュー担当者が通過させたポイントを、Blenderでの仕上げのために書き留めます。
picturesに、ループ、レビュー担当者への指示方法、画像が不合格になる条件、画像の測定方法が記載されています。
モデルを選択します。 --modelを指定しない場合、すべての実行でP2が使用され、H3.1の約3倍のコストがかかります。
| モデル | フラグ | ドライラン見積もり | 使用用途 |
|---|---|---|---|
| H3.1 | --model tripo-v3.1 | 10~50クレジット。詳細なPBRマップ付き画像は40 | 詳細な立体物: 彫刻、小道具、岩 |
| P2 (デフォルト) | --model tripo-p2 | 100~130クレジット。プレーンな画像は110 | クリーンなローポリトポロジ、四角面 |
ドライランを実行します。 ドライランは何も送信せず、何も消費しません:
tripo make ref.png --model tripo-v3.1 --seed 7 \
-p face_limit=30000 -p pbr=true -p texture_quality=detailed \
-p texture_version=v3.5-20260815 -p delight=true \
--name statue -o tripo-out/statue --dry-run --json
validはtrue、errorsは空である必要があります。warnings内の各エントリはCLIが削除した設定であり、その要件は満たされないことを意味します。支払う前に解決してください。generation_credits_estimateは、生成単体のリスト価格です。
実行します。 --dry-runなしで実行します。コマンドは、モデル、preview.png、task.jsonが-oフォルダに配置されるまでブロックし、その後1行のJSONを出力します。ファイル名はオプションによって変わるため(例: pbr_model.glb)、モデルのパスはmodel_fileフィールドから取得します。続行する前にpreview.pngを確認してください。
生の結果を保持します。 ダウンロードリンクは約5分で期限切れになり、後のモデルバージョンでは同じシードから別のメッシュが生成されるため、ダウンロードしたファイルが唯一のコピーです:
mkdir -p assets/raw/statue
cp tripo-out/statue/* assets/raw/statue/ # model, task.json, preview.png
そのフォルダをコミットするか、プロジェクトのソースアセットと一緒に保持してください。すべてのBlenderステップはこのコピーを読み取り、ネットワークにはアクセスしないため、再ビルドでは同じファイルが得られます。
停止して人間に確認を求めます:
- 50クレジットを超えると推定される実行、P2実行、および推定値の合計が150クレジットを超えるバッチの前。
- 終了コード4(クレジット不足)の後。すべての再試行は同じように失敗するため、人間に
tripo topupを伝えて待ちます。 tripo redoの前。これは新しいシードを使用した新しい有料実行であり、ドライランがないため。
4. Blenderで仕上げる
両方のスクリプトはウィンドウなしで実行され、ネットワークを使用することはありません。
正面を見つけます。 Tripoのドキュメントでは、生成されたモデルの前方軸として+xが指定されています。Blenderの正面図は+yに沿って見て、-yに面する側面を表示するため、+xを-yに変換するには--turn -90となります。すべてのメッシュがデフォルトに従うとは限らないため、まず生のモデルをレンダリングしてfront.pngを確認します:
blender --background --factory-startup \
--python <skill-dir>/tools/preview_model.py -- \
assets/raw/statue/<model>.glb build/statue-raw --size 640
これにより、約2秒でfront.png、side.png、top.pngが書き込まれます。
仕上げます:
blender --background --factory-startup \
--python <skill-dir>/tools/finish_model.py -- \
assets/raw/statue/<model>.glb build/statue.glb \
--height 6.5 --name statue --turn -90 --levels 0.4,0.12 --texture 1024
スクリプトはすべてのトランスフォームを頂点にベイクし、パーツを1つのオブジェクトに結合し、重複した頂点をマージします。モデルを垂直軸周りに--turn度回転させ、--heightメートルにスケーリングし、中心に配置し、最下点を地面に配置します。次に、--textureテクセルより長いテクスチャを縮小し、statue.glbに加えて、三角形を40%と12%にカットしたstatue-1.glbとstatue-2.glbを書き込みます。最後の行FINISHED {...}は、サイズ、縮小されたテクスチャ、各ファイルの三角形の数とバイト数を示します。--heightのみ必須です。--turnのデフォルトは0で、--levelsまたは--textureがない場合、コピーは作成されず、テクスチャは保持されます。
仕上げたファイルを同じ方法でレンダリングして、再度確認します。向きが間違っている場合は、--turnを変更して生のファイルから再度仕上げます。エクスポートしたファイルを回転させないでください。
新しい実行に料金を支払う前に、Blenderで修正します。 スケール、向き、ピボット、三角形の数、テクスチャサイズ、色、小さな塊や穴、融合したパーツはBlenderの作業です。形状自体が間違っている場合にのみ、Tripo3Dに戻ってください。blenderに対応表があります。
ライブBlenderを使用して試行します。 例えば、手のスカルプトやビューの比較など。出荷されるすべての変更は、生のファイルからモデルを再構築するスクリプトに組み込まれます。手動編集は繰り返しやレビューができず、次の再生成で失われるためです。プロジェクトですでにBlenderスクリプトでモデルを構築している場合は、このスクリプトの出力を出荷する代わりに、これらの手順をそのビルドに追加してください。