API 快速開始
建立並輪詢圖片生成影片任務。
1. 設定憑證
export SEEDANCE_BASE_URL="https://api.seedance2video.io/v1"
export SEEDANCE_API_KEY="sd_live_replace_me"Key 只應儲存在伺服器 Secret Manager 或 n8n Credential。
2. 建立任務
輸入網域必須先加入該 API Key 的白名單。
curl --request POST "$SEEDANCE_BASE_URL/videos" \
--header "Authorization: Bearer $SEEDANCE_API_KEY" \
--header "Idempotency-Key: order-10086-shot-1" \
--header "Content-Type: application/json" \
--data '{
"model": "seedance-2.0-pro",
"mode": "image-to-video",
"prompt": "主體緩慢轉向鏡頭，背景保持穩定。",
"inputs": [{"type":"image","url":"https://media.example.com/reference.png"}],
"parameters": {"duration_seconds":5,"resolution":"720p","aspect_ratio":"16:9","generate_audio":true}
}'API 回傳 202、任務 id、status_url 與實際的 billing.cost_credits，計費與 PC 版一致。
3. 輪詢同一任務
curl "$SEEDANCE_BASE_URL/generations/GENERATION_ID" \
--header "Authorization: Bearer $SEEDANCE_API_KEY"狀態為 queued 或 processing 時，依 retry_after_seconds 或 Retry-After 繼續輪詢。完成後讀取 output.video_url 或 output.image_urls。
建立請求逾時時，必須用完全相同的本文與 Idempotency-Key 重試，不可自動換新 Key 建立替代任務。
建立成功受理時回傳 202 Accepted。完成回應維持以下結構與 same_as_pc 策略：
{
"status": "completed",
"output": {
"urls": ["https://.../completed-video.mp4"],
"video_url": "https://.../completed-video.mp4"
},
"billing": {
"unit": "credits",
"cost_credits": 355,
"policy": "same_as_pc"
}
}第一個影片網址位於 output.video_url。