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 和确认流程。

图片输入 · 错误与重试