3D
3Dモデルの作成
3Dモデル生成タスクを作成します
現在の3Dモデルを取得するには GET /v1/models?recommended_for=3d を使用してください。
テキストまたは画像から3Dモデルを生成します。これは非同期APIです。作成レスポンスはタスク識別子を返します。これを使用して GET /v1/tasks/{id} をポーリングし、ステータスを確認してください。
操作は text-to-3d または image-to-3d です。operation は省略可能です。プロンプトのみのリクエストは text-to-3d として解決され、image または image_url を含むリクエストは image-to-3d として解決されます。operation を送信する場合は、入力と一致している必要があります。image-to-3d には画像が必要であり、text-to-3d には画像を含めません。従来の 3d-generation 値は 400 unsupported_operation を返します。各モデルがサポートする操作は一部のみです。詳細は GET /v1/models/{model} を確認してください。
リクエストボディ
オプションフィールドを送信する前に、GET /v1/models/{model} でモデルが受け付けるパラメータを確認してください。以下の例では model と prompt のみを使用しています。
tripo-h3.1使用するモデル(例:tripo-h3.1 や tripo-p1.0)。特定の入力タイプや出力形式に依存する前に、GET /v1/models?recommended_for=3d をクエリして確認してください。
text-to-3d または image-to-3d。任意。省略された場合は入力から推測されます。
生成する3Dモデルのテキストによる説明。最大2000文字です。モデルによってより短い制限が設定されている場合があります。詳細は各モデルの情報を参照してください。現在のモデルでは、Image-to-3Dリクエストにも prompt が必要です。指定しない場合、リクエストは 400 prompt is required を返します。
Image-to-3D生成用のBase64エンコードされた画像。
Image-to-3D生成用の画像の公開URL。
出力形式。サポート状況および使用可能な値は、選択したモデルによって異なります。
品質設定。サポート状況および使用可能な値は、選択したモデルによって異なります。
モデルのスタイルプリセット。
選択したモデルでサポートされている場合の整数シード値。
エンドユーザーの一意の識別子。選択したモデルが受け付ける場合のみ送信してください。
一部のモデルでは、n、negative_prompt、および output_format(format のエイリアス)もリストされています。これらは、モデルの詳細に記載されている場合にのみ送信してください。
レスポンス
ステータスポーリング用のタスクID。
アダプターによって返される非同期タスク識別子のエイリアス。
このタスクのステータスURL。id を指定して GET /v1/tasks/{id} をポーリングします。
タスクのステータス: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"
作成リクエストを安全に再試行するためのオプションのキー。タスクごとに新しい一意の値(UUIDなど)を送信してください。同じキーとボディで再試行すると、元の作成リクエストの結果(通常は元のタスク)が返され、2つ目のタスクの作成、ディスパッチ、課金は行われません。すでに受け入れられたキーで異なるボディを指定すると、409で拒否されます。255文字を超えるキーは無視され、そのリクエストには冪等性保護が適用されません。詳細は冪等性キーを使用した安全な再試行を参照してください。
1 <= length <= 255リクエストボディ
application/json
レスポンス
application/json
application/json
application/json
application/json
application/json
application/json