按能力

3D 模型

用文字或圖片生成 3D 模型，再貼圖、減面或綁定骨架。每一步都是一個單獨的任務。

#1. 選模型

tripo-3d$0.22 / 次限制和狀態

這個能力有 1 個線上模型，切換後下面的程式碼會跟著變。

#2. 複製請求

把 YOUR_API_KEY 換成你的金鑰再執行。顯示的選項都是這個模型支援的。

一段文字提示詞。

model3d.sh

curl https://www.aisplice.store/v1/model3d/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tripo-3d",
    "operation": "text_to_model",
    "prompt": "A small ceramic fox, stylised, smooth glaze",
    "texture": true,
    "pbr": true
  }'
# → {"task_id": "…", "status": "queued"}

curl https://www.aisplice.store/v1/model3d/tasks/$TASK_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

全部欄位：見 API 參考裡的 /v1/model3d/tasks →

#3. 拿到結果

提交後馬上回傳 task_id。每隔幾秒查一次，直到 status 變成 completed；也可以傳 webhook_url，完成後我們會回呼你。

GET https://www.aisplice.store/v1/model3d/tasks/{task_id}

status 變成 completed 後，模型檔案網址在 url（也在 output.model_url）裡。3D 沒有 /content 路由。

成功才扣費

失敗或取消的任務自動退款，請求日誌裡能看到每個任務的最終費用。

狀態值和輪詢方式 →改用回呼，不用反覆查詢 →

#出錯了怎麼辦

找不到輸入任務：貼圖、分割、重拓撲和綁定骨架都要用一個已完成的 3D 模型的任務 ID。
402：餘額不夠這次請求，到「錢包」儲值後重試。
429：請求太快，按 Retry-After 給的秒數等一下再試。
503 model_not_found：模型名寫錯了或模型暫時下線，從第 1 步重新選一個。

查詢其他錯誤 →

#串聯多個步驟

先生成模型，再把它的任務 ID 作為 input 傳給貼圖、分割、重拓撲或綁定骨架。每一步都按單獨的任務計費。

還是沒解決？

把請求 ID 或錯誤訊息傳給我們，我們來查。