Seedance 2.5 API
快速開始
完成第一次報價、生成和下載。
1. 設定認證
在帳戶設定中建立新金鑰，儲存在伺服器端金鑰管理工具中。金鑰僅顯示一次。
export SEEDANCE_BASE_URL="https://seedance2-5.com/api/v1"
export SEEDANCE_API_KEY="YOUR_API_KEY"2. 準備請求並報價
cat > video.json <<'JSON'
{
"model": "seedance-2.5-lite",
"mode": "text-to-video",
"prompt": "A cat walking through a sunny garden, cinematic camera movement",
"parameters": {
"duration_seconds": 8,
"resolution": "720p",
"aspect_ratio": "16:9"
},
"max_cost_credits": 80
}
JSONcurl --fail-with-body "$SEEDANCE_BASE_URL/quotes" \
-H "Authorization: Bearer $SEEDANCE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @video.json報價回傳 cost_credits，不會生成或扣點數。本例 Seedance 2.5 Lite 的 8 秒影片目前為 80 點數；超過 max_cost_credits 的價格會在生成前被拒絕。
3. 提交生成
curl --fail-with-body "$SEEDANCE_BASE_URL/videos" \
-H "Authorization: Bearer $SEEDANCE_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: video-order-0001" \
--data-binary @video.json每個新的生成意圖使用不同冪等識別碼；逾時重試必須保留同一 API 金鑰、冪等識別碼和請求本文。儲存 202 回傳的 id。
{
"id": "api_0000000000000000000000000000000000000000000000000000000000000000",
"model": "seedance-2.5-lite",
"status": "processing",
"created_at": "2026-10-03T12:00:00.000Z",
"credits": {
"cost": 80
},
"outputs": [],
"error": null
}4. 查詢並下載
curl --fail-with-body "$SEEDANCE_BASE_URL/generations/GENERATION_ID" \
-H "Authorization: Bearer $SEEDANCE_API_KEY"將 GENERATION_ID 替換為回傳的 id。同一個處理中任務至少間隔 10 秒查詢。status 為 success 後，在 expires_at 之前下載 outputs[].url。連結最多有效 15 分鐘，生成檔案保留 14 天。
圖片生成使用圖片模型、text-to-image 和 POST /images。參考圖片請查看 圖片輸入.