Seedance 2.5 API

n8n 整合

設定憑證、穩定重試和非同步查詢。

1. 儲存憑證

建立 n8n Header Auth Credential:名稱 Authorization,值 Bearer YOUR_API_KEY,在每個 API HTTP Request 節點中選擇。請勿將金鑰寫入節點欄位或匯出的工作流程 JSON。

2. 報價並生成

用 HTTP Request 將生成 JSON POST 到 https://seedance2-5.com/api/v1/quotes。確認 cost_credits,設定最高點數限制,再 POST 到 /videos 或 /images。

Idempotency-Key: seedance-{{$execution.id}}-shot-001

執行 ID 範例僅在同一次執行內穩定。業務可能在另一次執行中恢復時,需要在工作流程外儲存原冪等識別碼和請求本文;不能在結果未知的重試時使用新的執行 ID。

3. 等待並查詢

Trigger → Quote → Create → Save generation id → Wait 20–30s → Get status → Switch
                                                      ↑                     │
                                                      └── pending/processing┘

success → Download outputs
failed/canceled/expired → Stop and report

儲存 Create 回傳的 ID,使用原 Credential GET /generations/{id}。pending 或 processing 時等待 20–30 秒,Retry-After 更長則依其執行。錯誤分支保留原請求,不重新建立生成。

4. 儲存結果

{{$json.outputs[0].url}}

僅在 success 分支且 outputs 非空時讀取該運算式,多張圖片遍歷 outputs。在 expires_at 前下載,儲存下載請求請勿帶有 API Bearer 金鑰。圖片輸入需要完成圖片指南中的準備上傳、PUT 和確認流程。

圖片輸入 · 錯誤與重試