3D

3Dモデルの作成

3Dモデル生成タスクを作成します

POST
/v1/3d/generations

現在の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 のみを使用しています。

modelstringデフォルト: tripo-h3.1

使用するモデル(例:tripo-h3.1 や tripo-p1.0)。特定の入力タイプや出力形式に依存する前に、GET /v1/models?recommended_for=3d をクエリして確認してください。

operationstring

text-to-3d または image-to-3d。任意。省略された場合は入力から推測されます。

promptstring必須

生成する3Dモデルのテキストによる説明。最大2000文字です。モデルによってより短い制限が設定されている場合があります。詳細は各モデルの情報を参照してください。現在のモデルでは、Image-to-3Dリクエストにも prompt が必要です。指定しない場合、リクエストは 400 prompt is required を返します。

imagestring

Image-to-3D生成用のBase64エンコードされた画像。

image_urlstring

Image-to-3D生成用の画像の公開URL。

formatstring

出力形式。サポート状況および使用可能な値は、選択したモデルによって異なります。

qualitystring

品質設定。サポート状況および使用可能な値は、選択したモデルによって異なります。

stylestring

モデルのスタイルプリセット。

seedinteger

選択したモデルでサポートされている場合の整数シード値。

userstring

エンドユーザーの一意の識別子。選択したモデルが受け付ける場合のみ送信してください。

一部のモデルでは、n、negative_prompt、および output_format(format のエイリアス)もリストされています。これらは、モデルの詳細に記載されている場合にのみ送信してください。

レスポンス

idstring

ステータスポーリング用のタスクID。

task_idstring

アダプターによって返される非同期タスク識別子のエイリアス。

poll_urlstring

このタスクのステータスURL。id を指定して GET /v1/tasks/{id} をポーリングします。

statusstring

タスクのステータス:pending、processing、completed、または failed。

createdinteger

タスク作成日時の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"
  }'

レスポンス

Response
{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "created": 1706000000,
  "model": "tripo-h3.1"
}

認証

BearerAuth
AuthorizationBearer <token>

APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。

場所: header

ヘッダー

X-TokenLab-Delivery-Policy?string

リクエストごとの配信ポリシー。APIキーおよびWorkspaceのデフォルト設定を上書きします。自動的にまず TokenLab Verified を試行し、出力、リクエストの受け入れ、または永続的なリソース作成の前に、一度だけ Official に切り替える場合があります。

指定できる値

  • "auto"
  • "verified"
  • "official"
Idempotency-Key?string

作成リクエストを安全に再試行するためのオプションのキー。タスクごとに新しい一意の値(UUIDなど)を送信してください。同じキーとボディで再試行すると、元の作成リクエストの結果(通常は元のタスク)が返され、2つ目のタスクの作成、ディスパッチ、課金は行われません。すでに受け入れられたキーで異なるボディを指定すると、409で拒否されます。255文字を超えるキーは無視され、そのリクエストには冪等性保護が適用されません。詳細は冪等性キーを使用した安全な再試行を参照してください。

長さ1 <= length <= 255

リクエストボディ

application/json

レスポンス

application/json

application/json

application/json

application/json

application/json

application/json