n8n 連携

1. 認証情報を保管

n8n の Header Auth Credential を作成し、名前に Authorization、値に Bearer YOUR_API_KEY を設定します。各 API HTTP Request ノードで選択してください。ノードのフィールドやエクスポート JSON にキーを入れないでください。

2. 料金確認と生成

JSON の生成本文で https://seedance2-5.com/api/v1/quotes に POST します。cost_credits を確認し、クレジット上限を設定して /videos または /images に POST します。

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 で /generations/{id} を GET します。pending または processing の間は 20–30 秒待ち、Retry-After が長ければ従います。エラー時は元のリクエストを保持し、別の生成を作り直さない分岐を用意します。

4. 出力を保存

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

success 分岐で outputs が空でないことを確認してから使用します。複数画像は outputs を繰り返します。expires_at までにダウンロードし、ストレージへのダウンロードに API キーを付けないでください。画像入力はガイドのアップロード、PUT、確認手順が必要です。

画像入力 · エラーと再試行