3D
3Dモデルの作成
3Dモデル生成タスクを作成します
Tripo3Dやその他のプロバイダーを使用して、テキストまたは画像から3Dモデルを生成します。これは非同期 API です。作成レスポンスはタスク ID を返し、利用可能な場合は優先して使う poll_url も返します。
公開 3D operation はリクエスト形状から推定されます。prompt のみのリクエストは text-to-3d、image または image_url を含むリクエストは image-to-3d として扱われます。この endpoint は operation リクエストフィールドを公開していません。旧来の 3d-generation 値は送信しないでください。
リクエストボディ
オプションのフィールドを送信する前に、GET /v1/models/{model} でモデルが受け付けるパラメータを確認してください。例では model と prompt のみを送信します。
tripo-h3.1使用するモデルです。例: tripo-h3.1 または tripo-p1.0。特定の入力タイプや出力形式に依存する前に GET /v1/models?recommended_for=3d を確認してください。
生成する3Dモデルのテキスト説明。
Image-to-3D生成用のBase64エンコード済み画像。
Image-to-3D生成用の画像のURL。
出力形式。対応状況と指定可能な値はモデルによって異なります。
品質設定。対応状況と指定可能な値はモデルによって異なります。
モデルのスタイルプリセット。
選択したモデルで対応している場合に使用する整数シード。
エンドユーザーの一意識別子。
レスポンス
ステータス確認（ポーリング）用のタスクID。
アダプタが返す場合の非同期タスク ID 別名です。
利用可能な場合に返される優先ポーリング URL です。
タスクのステータス：pending、processing、completed、またはfailed。
タスク作成時のUnixタイムスタンプ。
リクエスト
curl -X POST "https://api.tokenlab.sh/v1/3d/generations" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "tripo-h3.1",
"prompt": "A detailed medieval castle with towers"
}'レスポンス
{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "pending",
"created": 1706000000,
"model": "tripo-h3.1"
}認証
BearerAuth APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。
場所: header
ヘッダー
リクエストごとの配信ポリシー。APIキーおよびWorkspaceのデフォルト設定を上書きします。自動的にまず TokenLab Verified を試行し、出力、リクエストの受け入れ、または永続的なリソース作成の前に、一度だけ Official に切り替える場合があります。
指定できる値
- "auto"
- "verified"
- "official"
リクエストボディ
application/json
レスポンス
application/json
application/json