Tripo CLI：AI でテキストや画像を 3D モデルに変える
Tripo CLI は AI エージェントのために設計されており、3D 制作をチャットのように簡単にします。Codex、Claude Code、Cursor などの AI コーディングツールの中でも、CLI を直接使う場合でも、自然言語の説明ひとつ、画像 1 枚、または既存のモデルがあれば、3D モデルやアニメーションなどのアセットを生成・変換できます。CLI がプロセス全体を自動で完了するため、API やモデルバージョン、複雑なパラメーターを理解する必要はありません。
CLI と API のどちらを使えばいい？
Tripo には 2 つの使い方があります。10 秒で自分に合うものを選びましょう。
| 製品 | 向いている用途 | 行き先 |
|---|---|---|
| Tripo CLI（このページ） | 初心者向け。主要な Vibe Coding ツールで AI 3D 機能をすばやく活用したい | このまま読み進めてください |
| Tripo API | プロ開発者向け。AI 3D 機能を Web サイト・アプリ・自社の業務システムに組み込みたい | クイックスタート |
迷ったら、まずこのページを試してください。インストールは無料で、クレジットは実際にモデルを生成したときにだけ消費されます。
インストールとサインイン（2 つの方法から 1 つを選ぶ）
以下の 2 つのインストール方法から、どちらか 1 つを選んでください。
方法 1：AI にインストールしてもらう（推奨）
Cursor、Claude Code、Codex など、ターミナルのコマンドを実行できる AI アシスタントをすでに使っている場合は、これが一番簡単な方法です。以下のプロンプトをコピーして、丸ごとアシスタントに送ってください。
Tripo CLI を設定し、各手順を説明してください。Node.js 20 以降がインストール済みか確認し、npm install -g tripo-cli を実行してください。Windows PowerShell でスクリプトの実行が無効になっている場合は、先に Set-ExecutionPolicy -Scope CurrentUser RemoteSigned を実行してから（管理者としては実行しない）再試行してください。サインイン前に、私のアカウントが使うサイトが海外の developers.tripo3d.ai（ov）か、中国本土の developers.tripo3d.com（cn）かを確認してください。言語やサインイン方法から推測しないでください。回答に従って tripo login --region ov または tripo login --region cn を実行してください。認証用 URL とワンタイムコードを私に伝え、私がブラウザで認証する間はコマンドを実行したまま待機してください。API Key をチャットに貼るよう求めないでください。最後に tripo doctor を実行し、認証、ネットワーク、残高の確認が成功したか教えてください。
この後の流れは次のとおりです。
- AI がコンピューターの状態を確認します。Node.js が入っていなければ、先にインストールを手伝ってくれます。
- AI がインストールコマンドを実行します。
- ここはあなたの番です。アカウントのサイトを確認し、AI から提供された認証用 URL を開き、承認前にターミナルに表示されたワンタイムコードを入力または確認してください（この手順は必ず自分で行ってください。いかなるキーも AI に送ってはいけません）。
- AI が
tripo doctorを実行します。すべてのチェックが成功すれば、セットアップ完了です。
あとは次のセクション「最初の 3D モデルを作成する」へそのまま進んでください。
困ったときは：AI が途中で止まった、またはエラーになった
- ターミナルのエラーをそのまま AI に貼り付けて、続きを任せてください。たいていの問題は AI が解決できます。
- サインインが完了しない場合：サインインページを開き直し、ターミナルに表示された確認コードをもう一度確かめてから承認してください。
- それでも解決しないときは、下の「方法 2：自分でインストールする」に切り替えてください。必要なのはコマンド 3 つだけです。
方法 2：自分でインストールする
AI アシスタントがなくても問題ありません。全部でコマンド 3 つだけです。
ステップ 1：Tripo CLI をインストールする
次のコマンドで、コンピューターに tripo コマンドをインストールします。
npm install -g tripo-cli
正常であれば、赤いエラー文字が出ないまま進行表示が終わります。これでインストールは成功です。
すでにインストール済みですか？ tripo update --check で新しいバージョンを確認し、tripo update でインストールしてください。
困ったときは：npm が見つからない、または権限エラーが出る
npmが見つからない：Node.js がまだインストールされていません。Node.js 公式サイトから現行の LTS 版（20 以降）をインストールし、ターミナルを開き直してからもう一度試してください。- macOS で権限エラー（EACCES）が出る：代わりに
sudo npm install -g tripo-cliを実行し、求められたらコンピューターのパスワードを入力してください。 - Windows で「スクリプトの実行が無効になっています」と表示される：PowerShell で
Set-ExecutionPolicy -Scope CurrentUser RemoteSignedを実行し（管理者権限は不要）、ターミナルを開き直してからもう一度試してください。その他の例は後述の「Windows / PowerShell」を参照してください。
ステップ 2：Tripo アカウントにサインインする
海外アカウントを developers.tripo3d.ai で使用している場合（Stripe 請求）は、次を実行します。
tripo login --region ov
中国本土アカウント（developers.tripo3d.com、Alipay）の場合は、代わりに tripo login --region cn を使います。対話型ターミナルでは、リージョンなしの tripo login を実行すると、先にアカウントのサイトを選ぶよう求められます。
ブラウザが選択したサイトの認証ページを自動的に開きます（アカウントがまだない場合は、まずそこで登録してください）。ターミナルに表示されたワンタイムコードを入力または確認してから認可してください。 認可が終わると、CLI が自動的にキーを受け取り、ログイン完了を知らせます。
困ったときは：ブラウザが開かない、またはサインインが完了しない
- サインインが完了しない：もう一度
tripo loginを実行し、ターミナルに表示されたコードをよく確かめてから承認してください。 - ブラウザが反応しない：ターミナルに表示された URL をコピーして、手動でブラウザに貼り付けて開いてください。
- ブラウザ認証が一時的に利用できない：対話型ターミナルでは API Key ページにフォールバックします。AI エージェントなどの非対話セッションでは、正しい
TRIPO_REGIONとともにTRIPO_API_KEYを使うか、tripo login --key tsk_...を実行するか、対話型ターミナルで再試行してください。以下の「予備のサインイン方法とリージョン」を参照してください。
ステップ 3：すべての準備が整ったか確認する
tripo doctor
サインイン状態、ネットワーク接続、クレジット残高を順番に確認します。3 つすべて成功すれば、セットアップ完了です。
困ったときは：いずれかのチェックが失敗した
- 認証チェックが失敗：サインインが完了していません。
tripo loginを実行して、もう一度サインインしてください。 - ネットワークチェックが失敗：コンピューターで Web ページを開けるか確認してください。会社や学校のネットワークではプロキシが必要な場合があります。
- 残高チェックが失敗：クレジットが不足しています。まだ何も生成されておらず、課金もされていません。
tripo topupを実行すると請求ページが開きます。
予備のサインイン方法とリージョン（ブラウザでサインインできない場合のみ）
- すでに API Key を持っている場合は、
tripo login --key tsk_...を実行するか、そのアカウント用のTRIPO_REGION（ovまたはcn）とともにTRIPO_API_KEYを設定してください。 - API Key はアカウントの認証情報です。チャット、ソースコード、スクリーンショット、ログには絶対に貼り付けないでください。
tripo login --key tsk_...は両リージョンでキーを確認し、受け付けられたリージョンを自動的に保存します。TRIPO_API_KEYを直接設定しても、この検出は行われません。ブラウザ認証の前には、海外はov、中国本土はcnと、サイトを明示的に選択してください。- AI エージェントなどの非対話セッションでキーがない場合は、
--regionが必要です。CLI は認証用 URL とワンタイムコードを表示し、人が認可するまで待機します。開始前にアカウントのサイトを確認し、言語やサインイン方法から推測しないでください。
Windows / PowerShell
このページのコマンドは Bash 向けに書かれています。Windows でも同じように動作しますが、PowerShell は一部のトークンを Bash や cURL とは異なる方法で解釈します。PowerShell では Bash のコードブロックをそのまま貼らず、次の例を使ってください。
tripo の実行を許可する
npm は tripo.ps1 シムをインストールしますが、PowerShell は既定でこれをブロックします。
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
ターミナルを開き直してから tripo doctor を実行してください。管理者権限は不要です。ポリシーを変更したくない場合は、コマンド プロンプト（cmd.exe）を使ってください。
@last とカンマ区切りのフラグを引用符で囲む
PowerShell は @name を特殊な構文、, をリストの区切りとして扱います。
tripo make "a cute low poly fox"
tripo view '@last'
tripo make hero.glb --then 'texture,rig'
tripo make '@last' --then 'convert:fbx'
コマンド プロンプトでは、これらの追加の引用符は不要です。
環境変数
# 現在のウィンドウのみ
$env:TRIPO_API_KEY = "tsk_..."
$env:TRIPO_REGION = "ov"
$env:TRIPO_PROFILE = "work-ov"
# Windows ユーザーに対して永続化する
[System.Environment]::SetEnvironmentVariable("TRIPO_API_KEY", "tsk_...", "User")
[System.Environment]::SetEnvironmentVariable("TRIPO_REGION", "ov", "User")
設定と履歴は %USERPROFILE%\.tripo（Windows における ~/.tripo 相当）に保存されます。
JSON パイプライン
# PowerShell 7 以降（推奨）
tripo make cat.png --json | tripo model texture --json | tripo anim rig --json
# Windows PowerShell 5.1
$json = tripo make cat.png --json --no-open
$json | tripo model texture --json
英語以外のプロンプトが文字化けする場合は、Windows Terminal を使うか、先に chcp 65001 を実行してください。
最初の 3D モデルを作成する
ステップ 1：1 つの文章から生成する
引用符の中の文章があなたのプロンプトです。作りたいものの説明に置き換えてください。
tripo make "a cute low poly fox"
コマンドの実行中はターミナルを開いたままにしてください。Tripo CLI が適切なワークフローとモデルを選び、タスクの完了を待って、現在のディレクトリの tripo-out フォルダーにファイルをダウンロードします。全体はたいてい数分以内に終わり、消費するクレジットもわずかです。
困ったときは：生成が始まらない、または途中で失敗した
- クレジット不足：モデルの生成はまだ始まっておらず、課金もされていません。
tripo topupでクレジットをチャージしてから、もう一度試してください。 - ネットワークエラーまたは送信中の HTTP 5xx：タスクがすでにサーバー上に存在する場合があります。
tripo balanceで凍結中のクレジットを確認し、再送信前にコンソールを確認してください。タスク ID があれば、tripo task watch <task-id> --downloadで再開できます。 - 待機がタイムアウトした場合：タスクはまだ実行中で、成功すれば課金される可能性があります。
tripo task watch <task-id> --downloadで再開してください。タイムアウトの復旧のためにmakeを繰り返したり、redoを使ったりしないでください。 - タスク失敗：消費されたクレジットは自動的に払い戻されます。別の説明文で試してみてください。
ステップ 2：プレビューを開く
tripo view @last
@last は「最新のタスク」という意味です。ブラウザに、ドラッグで回転できるインタラクティブな 3D プレビューが開きます。自分のモデルが表示されたら、完成です！PowerShell では tripo view '@last' と書いてください。
最初の成功のあとに：いま手元にあるもの
- ファイルの場所：
tripo-outの下にできた新しいフォルダーに、ダウンロードされた 3D モデルと、タスクの作成内容を記録したtask.jsonが入っています。サーバーがプレビュー画像を返した場合はpreview.pngも入ります。 - もう一度開くには：いつでも
tripo view @lastを実行できます。任意のモデルファイルを開くにはtripo view <file>を使います。 - 費用の確認：
tripo balanceを実行するとクレジット残高を確認できます。 - コマンドを覚えるのが苦手？
tripoを実行するだけで、案内付きのインタラクティブメニューが開きます。サインイン、生成、プレビュー、チャージがすべてそこにまとまっています。 - 次のステップ：画像から生成する（次のセクション）、AI アシスタントに任せる（「AI コーディングエージェントに CLI をマスターさせる」）、一括処理する（「すぐ使えるワークフローとパイプライン」）。
画像や既存モデルから生成する
文章の例がうまくいったら、今度はローカルファイルを渡せます。以下の concept.png、front.png、hero.glb はサンプル名なので、自分のファイルパスに置き換えてください。
tripo make concept.png --for print
tripo make front.png back.png
tripo make hero.glb --then texture,rig
tripo make @last --then convert:fbx
- 1 行目：コンセプト画像を、3D プリントに対応したモデルに変換します。
- 2 行目：正面と背面の画像をまとめて渡し、ディテールをより正確に生成します。
- 3 行目：既存モデルにテクスチャとリグを適用します。
- 4 行目：最新の結果を FBX に変換します。
AI コーディングエージェントに CLI をマスターさせる
AI コーディングエージェントを使わない場合は、このセクションを飛ばしてください。npm パッケージには、コマンドリファレンス、シナリオ別レシピ、エラー復旧ガイドをまとめた Agent Skill が同梱されており、エージェントが CLI を正しく使えるようになっています。次のコマンドをエージェントに実行させると、手順の全文、または特定のトピックだけをターミナルに表示できます。
tripo docs --llm
tripo docs --topic commands/make
tripo docs --topic examples/game-asset
Skill に同梱されているファイル
skill/
├── SKILL.md
├── common-errors.md
├── commands/
│ ├── account.md
│ ├── batch.md
│ ├── generate.md
│ ├── make.md
│ ├── process.md
│ ├── task.md
│ └── view.md
└── examples/
├── animation.md
├── ar-web.md
├── film.md
├── game-asset.md
├── pipes.md
└── print.md
コマンドリファレンス
この表を暗記する必要はありません。ふだんの利用では、初心者は tripo（インタラクティブメニュー）、tripo make（生成）、tripo view（プレビュー）、tripo doctor（ヘルスチェック）だけで十分です。それ以外は、具体的に必要になったときに開いてください。
コマンド一覧と共通フラグを表示
| コマンド | 機能 |
|---|---|
tripo make <input...> |
1 つのコマンドで生成、処理、ダウンロード |
tripo ai [description] |
ジョブを計画し、確認して実行 |
tripo view [task|file] |
インタラクティブなローカル 3D プレビューを開く |
tripo redo [task] |
新しいシードでリクエストを再実行 |
tripo login / logout / whoami / use |
名前付きアカウントプロファイルを認証して切り替える |
tripo topup / balance / usage |
リージョン別の請求ページを開き、クレジットを確認 |
tripo generate <endpoint> |
8 つすべての生成エンドポイントへ明示的にアクセス |
tripo model / anim / mesh <step> |
リファイン、テクスチャ、リグ、変換、セグメンテーションなどの処理を実行 |
tripo mesh decimate [input] |
ポリゴン数を削減。v3.0 では同じタスクで UV 展開も可能 |
tripo mesh uv [input] |
UV を展開し、既存のテクスチャ、リグ、アニメーションを再マッピング |
tripo task get/list/watch |
タスクを照会、一覧表示、または完了まで待機 |
tripo history [--limit <n>] |
最近のローカルタスク履歴を表示 |
tripo files upload <path> |
ファイルをアップロードして file_token を返す |
tripo batch run <manifest.yaml> |
同時実行数と再試行を指定し、再開可能な一括パイプラインを実行 |
tripo config / doctor |
設定を管理し、ローカル環境を診断 |
tripo update [--check] |
最新の CLI をインストール、または更新の確認のみを実行 |
tripo docs [--topic <topic>] |
同梱の Agent ドキュメントとコマンドドキュメントを表示 |
tripo mcp |
CLI を MCP サーバーとして実行 |
tripo completion <shell> |
Bash、Zsh、Fish 用の補完を生成（PowerShell は非対応） |
make、ai、generate コマンドと、model、anim、mesh 配下の処理サブコマンドは、-o/--out、--no-wait、--no-download、--name、--timeout、--notify、および繰り返し指定できる --param key=value をサポートします。グローバルな自動化フラグには、--json、--yes、--quiet、--no-open、--profile があります。
すぐ使えるワークフローとパイプライン
ここは上級者向けのセクションで、最初の生成には必要ありません。7 つの組み込みプリセットが、--for <preset> の指定で便利なパラメータと処理手順をまとめて適用します。
game-mobile · game-pc · film · print · ar-web · anim · toy
# Mobile game asset: low-poly generation, texture, then FBX
tripo make "sci-fi crate" --for game-mobile
# Print asset: watertight output, STL, and a flat bottom
tripo make "chess knight" --for print
# Explicit processing chain
tripo make cat.png --then texture,rig,convert:fbx
# The same chain as NDJSON pipes
tripo make cat.png --json | tripo model texture --json | tripo anim rig --json
# Resumable batch processing
tripo batch run assets.yaml --concurrency 2
リトポロジーと UV 展開
decimate の既定は引き続き v2.0 です。新しいリトポロジーモデルには v3.0 を選択します。--smart-uv は同じタスクで UV を展開し、v3.0 でのみ使えます（このフラグを指定して --model を省略すると、v3.0 が選択されます）。
tripo mesh decimate hero.glb --model v3.0 --face-limit 5000 --smart-uv
tripo mesh uv hero.glb
独立した uv ステップは、既存のテクスチャ、リグ、アニメーションを新しい UV レイアウトに再マッピングし、UV アトラスも返します。入力は 80,000 相当三角形を超えてはいけません（1 quad は 2 triangles と数えます）。より大きなモデルでは、先に decimate してください。例：tripo make hero.glb --then decimate:20000,uv。PowerShell では、チェーンを 'decimate:20000,uv' のように引用してください。
@last、@2、@name などのタスク参照は、タスク ID を受け付ける場所ならどこでも使用できます。
複数のアカウントとリージョン
Tripo アカウントを 1 つだけ使う場合は、このセクションを飛ばして構いません。認証情報は名前付きプロファイルに保存されるため、2 つ目のアカウントにサインインしても最初のアカウントは上書きされません。
tripo login --region ov --profile personal-ov
tripo login --region cn --profile work-cn
tripo use personal-ov
tripo whoami
tripo make "a fox" --profile personal-ov
tripo logout
各プロファイルは独自のキーとリージョンを保持します。環境変数 TRIPO_PROFILE は現在の環境で使うプロファイルを選択します。TRIPO_API_KEY は保存されたキーを上書きしますが、そのリージョンを自動検出しません。環境変数でキーを渡す場合は、アカウントに合う TRIPO_REGION を設定してください。
各アカウントに一致するリージョンを使用してください。tripo topup はアクティブなプロファイルのリージョン別請求ページを開きます。海外サイトでは /billing、中国本土サイトでは /billing/recharge です。
AI コーディングエージェント向けの注意事項
人間のユーザーはこのセクションを飛ばして構いません。これらは、AI コーディングエージェントがタスクを正しく待機し、機械可読な出力を読み取るためのルールです。
tripo makeとtripo task watchはブロッキングコマンドです。別のポーリングループを実装せず、プロセスが終了するまで待機してください。--jsonを使用すると、ほとんどの単発コマンドは最終結果の JSON 1 行を stdout に出力します。一方、tripo task watch --jsonは進行状況イベントを NDJSON 形式でストリーミングし、最後に最終結果を出力します。preview.pngが存在する場合は、確認してからパイプラインを続行するかtripo redoを実行するか決めてください。- パラメータを推測したり、古いモデルバージョンを強制したりしないでください。サポートされているフラグは
tripo docs --topic ...で確認してください。 - ローポリのリクエスト、またはフェイス数上限が 20,000 以下の場合は
tripo-p1が選択され、それ以外はデフォルトでtripo-v3.1が使用されます。 tripo-p2は Preview モデルで、--model tripo-p2により明示的に選択する必要があります。quad のローポリ出力には-p quad=trueを追加してください。quad 出力では FBX が使われ、P1 は quad をサポートしません。CLI のモデルエイリアスを使用してください。CLI が API で必要な日付付きモデル値に変換します。tripo make "a low-poly robot" --model tripo-p2 --dry-runを使うと、アップロード、タスク作成、クレジット消費をせずにプランを確認できます。- タスク作成が自動再試行されるのは HTTP 429 のときだけです。ネットワークエラー、タイムアウト、HTTP 5xx では送信結果が不明確な場合があるため、再送信前にアカウントを確認してください。
終了コード表を表示
| 終了コード | 意味 |
|---|---|
0 |
成功 |
1 |
予期しないエラーまたは内部エラー |
2 |
使用方法またはパラメータが無効 |
3 |
認証エラー |
4 |
クレジット不足 |
5 |
コンテンツポリシーによる拒否 |
6 |
タスク失敗（クレジットは払い戻し）、または待機のタイムアウト（タスクがまだ実行中の可能性があるため、監視を再開） |
7 |
ネットワークエラー |
8 |
リソースが見つかりません |
9 |
レート制限。バックオフして再試行してください |
自動化用の環境変数
通常の対話的な利用では環境変数は不要です。CI、スクリプト、高度なエージェントワークフローのために用意されています。くれぐれも、API キーをリポジトリにコミットしたり、ドキュメントに貼り付けたり、スクリーンショットやログに含めたりしないでください。
公式の海外 API では、ランダムなインストール ID を使う匿名の利用分析が既定で有効です。コマンド結果と、モデル／種別、クレジット／所要時間、エラー分類、出力形式／ファイル数、エージェント帰属を含むタスクメタデータを記録します。プロンプト、ファイルパス、入力アセット、API キー、ダウンロード URL は含まれません。中国本土とカスタム API エンドポイントはこれらのイベントを送信しません。無効にするには TRIPO_ANALYTICS_ENABLED=0 を設定してください。
環境変数の一覧を表示
| 変数 | 用途 |
|---|---|
TRIPO_API_KEY |
保存されたキーを上書きしますが、そのリージョンは検出しません。スクリプトでは正しい TRIPO_REGION と組み合わせてください |
TRIPO_PROFILE |
名前付きアカウントプロファイル。--profile と同等 |
TRIPO_REGION |
API リクエスト用の ov または cn オーバーライド。非対話のブラウザ認証では login --region の代わりにはなりません |
TRIPO_API_BASE_URL |
API エンドポイントのオーバーライド |
TRIPO_PLATFORM_BASE_URL |
プラットフォームエンドポイントのオーバーライド |
TRIPO_HOME |
設定と履歴のディレクトリ。デフォルトは ~/.tripo |
TRIPO_NO_UPDATE_CHECK |
空でない任意の値（例：1）で、起動時の自動バージョンチェックを無効化 |
TRIPO_NPM_REGISTRY |
CLI バージョン照会用のレジストリ URL。既定は https://registry.npmjs.org。インストールでは npm のレジストリ設定を使用 |
HTTPS_PROXY / HTTP_PROXY / NO_PROXY |
CLI ネットワークリクエスト用のプロキシ URL と除外リスト。小文字の名前も使用可能 |
TRIPO_ANALYTICS_ENABLED |
匿名の利用分析を無効にするには、正確に 0 を設定。中国本土とカスタム API エンドポイントは何も送信しません |
TRIPO_LLM_BASE_URL |
tripo ai 用の任意の OpenAI 互換エンドポイント |
TRIPO_LLM_API_KEY |
tripo ai 用の任意の LLM キー |
TRIPO_LLM_MODEL |
tripo ai 用の任意の LLM モデル |