POST /v1/3d/generations はTokenLabタスクを作成します。完了したステータスのレスポンスは、model_urlなどのダウンロード可能なモデルアセットを返し、利用可能な場合はフォーマット特有のURLも返します。
入力タイプの選択
どのオプションを公開するか決定する前に、モデルカタログをクエリしてください：
この endpoint では
operation フィールドではなく入力タイプを使用します。モデル metadata では 3D 機能が text-to-3d や image-to-3d として示されます。3d-generation は公開リクエスト operation ではありません。
tripo-h3.1 と、プロダクション向け 3D アセット生成の tripo-p1.0 があります。入力タイプと出力形式の対応は Models API で確認してください。
すべての3Dモデルが両方の入力タイプまたはすべての出力フォーマットをサポートしているとは限りません。 image, image_url, format, quality, style, または seedを送信する前に、選択したモデル詳細を確認してください。
3Dタスクの作成
image_url を使用してください。クライアントが意図的にプライベートメディアを送信し、バックエンドが大きなリクエストボディに対応できる場合のみ、インライン/base64の image を使用してください。
出力フォーマットの選択肢
glbは通常、ウェブプレビューのための最も安全なデフォルトです。fbxとobjは、選択したモデルがそれらをサポートしている場合にDCCパイプラインに役立ちます。usdzは、モデルによって公開されている場合にApple ARワークフローに役立ちます。- 高い
quality値はレイテンシとコストを増加させる可能性があります。明示的なユーザー選択として公開し、隠れたデフォルトとしては扱わないでください。 seedは、モデルがそれを尊重する場合にのみ再現性に役立ちます。
アセットのポーリングと保存
最初に返されたpoll_url を使用してください。クライアントが固定ルートを必要とする場合は、 GET /v1/tasks/{id} を使用してください。
model_url を返し、glb_url, fbx_url, obj_url, または usdz_url を含む場合があります。ユーザーが再アクセス、バージョン履歴、または長期的なダウンロードを必要とする場合は、選択したアセットを自社製品にダウンロードまたはキャッシュしてください。
プロダクションチェックリスト
task_id,poll_url, モデル, リクエストされたフォーマット、および自社のアセットレコードIDを保持してください。- ページをリフレッシュした後は、重複タスクを作成するのではなく、ポーリングを再開してください。
- タスクを作成する前に、ソース画像のサイズと到達可能性を検証してください。
- ユーザーがアセットにアクセスする権限を持っていない限り、生成されたアセットのURLを公開ページに出さないでください。
- 後の調整のために、存在する場合は
billing_transaction_idを記録してください。