3D
建立 3D 模型
建立 3D 模型生成任務
使用 Tripo3D 及其他供應商，透過文字或圖片生成 3D 模型。這是一個非同步 API。建立回應會返回任務身分，並且在可用時返回優先使用的 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 模型文字描述。
用於圖片轉 3D 生成的 Base64 編碼圖片。
用於圖片轉 3D 生成的圖片 URL。
輸出格式；是否支援及允許值取決於所選模型。
品質設定；是否支援及允許值取決於所選模型。
模型的風格預設。
整數種子，僅在所選模型支援時使用。
終端用戶的唯一識別碼。
回應 (Response)
用於輪詢狀態的任務 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 Key 驗證。請在 Dashboard > API > API Keys 建立或管理 API 金鑰。
位置: header
請求標頭
單次請求傳遞策略。會覆寫 API key 與 Workspace 的預設值。系統會自動優先嘗試 TokenLab Verified，並可能在輸出、請求接受或建立持久性資源前切換至 Official 模式一次。
可選值
- "auto"
- "verified"
- "official"
請求主體
application/json
回應
application/json
application/json