テキスト → 3D
POST/v1/models/from-text
アセットをテキストで説明すると、テクスチャ付きのメッシュが得られます。
パラメーター
| パラメーター | 説明 |
|---|---|
| prompt必須 string | 生成する対象。最大1,024文字（Tripo エンジンの上限）。 |
| engine任意 string | 使用する3Dエンジン。例: tripo、tripo-v3.1、hunyuan-3.1。省略するとデフォルトが使われます。正式な一覧: GET /v1/models?category=3d。 |
| polycount任意 integer | 目標ポリゴン数、100–2,000,000。範囲外の値はモデルの範囲（例: tripo 500–20,000）に制限されます。各モデルの polygonConfig は GET /v1/modelsで確認できます。 |
| texture任意デフォルト true boolean | PBRテクスチャを生成します。より高速でテクスチャなしのメッシュにするには false を指定します。 |
| license任意 string | 結果物の使用権。デフォルトは非公開（全権利保有）です。 |
| callbackUrl任意 string | ポーリングの代わりに、完成したアセットをサーバーへプッシュします。Webhookを参照してください。 |
リクエスト
リクエスト
curl -X POST https://api.picoberry.ai/v1/models/from-text \
-H "Authorization: Bearer pb_live_xxx" -H "Content-Type: application/json" \
-d '{"prompt":"a stylized treasure chest","engine":"tripo","polycount":10000}'requests.post("https://api.picoberry.ai/v1/models/from-text", headers=headers,
json={"prompt": "a stylized treasure chest", "engine": "tripo", "polycount": 10000})await fetch(`${BASE}/v1/models/from-text`, { method: "POST",
headers: { ...headers, "Content-Type": "application/json" },
body: JSON.stringify({ prompt: "a stylized treasure chest", engine: "tripo", polycount: 10000 }) });レスポンス
レスポンス · 200
{ "success": true, "data": { "id": "019…", "taskStatus": 0, "type": "model_3d" } }これは作成時のレスポンスです。ジョブはすでに実行中です。GET /v1/assets/{id}を taskStatus が 2 になるまでポーリングすると、files.model が署名付きの GLB になります。作成 → ポーリング → ダウンロードの一連の流れはクイックスタートを参照してください。