Seedance 2.5 API
非同步生成
查詢任務狀態，在有效期內儲存生成檔案。
生成狀態
透過 POST /videos 或 POST /images 建立任務。202 表示受理或冪等重放，並不表示檔案已生成。使用原金鑰查詢 GET /generations/{id}，處理中至少間隔 10 秒。
| Status | 含義 |
|---|---|
pending | 已受理，或仍待確認提交結果。 |
processing | 生成中，或正在準備儲存檔案。 |
success | 可取得下載連結。 |
failed | 生成失敗。 |
canceled | 任務已取消。 |
expired | 生成檔案保留期已結束。 |
成功回應
{
"id": "api_0000000000000000000000000000000000000000000000000000000000000000",
"model": "seedance-2.5-lite",
"status": "success",
"created_at": "2026-10-03T12:00:00.000Z",
"credits": {
"cost": 80
},
"outputs": [
{
"type": "video",
"url": "https://YOUR_SIGNED_OUTPUT_URL",
"expires_at": "2026-10-03T12:15:00.000Z"
}
],
"error": null
}讀取 outputs[].url。本 API 沒有 output.video_url 或 status_url 欄位，使用回傳的 id 建立查詢路徑。簽章連結請保密。
下載與保留期
每個連結最多有效 15 分鐘，不會超過檔案保留期限。保留期內可重新查詢取得新連結。生成檔案保留 14 天，請在到期前儲存到自己的儲存空間。
提交結果未知
網路中斷可能發生在受理之後。必須使用原請求本文和冪等識別碼重試。原任務持續 pending 時，保留 ID 並聯絡支援；請勿自動建立替代請求，可能再次扣費。結果未知的任務不會僅因時間經過而自動退款。