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 から取得します。