跳轉到主要內容
使用 Tripo3D 及其他供應商，透過文字或圖片生成 3D 模型。這是一個非同步 API。建立回應會返回任務身分，並且在可用時返回優先使用的 poll_url。

​
請求主體 (Request Body)

​
model
string
預設值:"tripo3d-v2.5"
要使用的模型（例如：tripo3d-v2.5、tripo3d-v2）。
​
prompt
string
必填
要生成的 3D 模型文字描述。
​
image
string
用於圖片轉 3D 生成的 Base64 編碼圖片。
​
image_url
string
用於圖片轉 3D 生成的圖片 URL。
​
format
string
預設值:"glb"
輸出格式：glb、fbx、obj 或 usdz。
​
quality
string
預設值:"standard"
品質等級：draft、standard 或 high。
​
style
string
模型的風格預設。
​
seed
integer
用於可重現生成的種子值。
​
user
string
終端用戶的唯一識別碼。

​
回應 (Response)

​
id
string
用於輪詢狀態的任務 ID。
​
task_id
string
適配器返回時的非同步任務 ID 別名。
​
poll_url
string
可用時返回的優先輪詢 URL。
​
status
string
任務狀態：pending、processing、completed 或 failed。
​
created
integer
任務建立的 Unix 時間戳記。
curl -X POST "https://api.lemondata.cc/v1/3d/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tripo3d-v2.5",
    "prompt": "A detailed medieval castle with towers",
    "format": "glb",
    "quality": "high"
  }'

{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "created": 1706000000,
  "model": "tripo3d-v2.5"
}