クイックスタート

1. 認証を設定

設定画面で新しいキーを作成し、サーバーのシークレット管理機能に保存してください。一度だけ表示されます。

export SEEDANCE_BASE_URL="https://seedance2-5.com/api/v1"
export SEEDANCE_API_KEY="YOUR_API_KEY"

2. リクエストと料金を確認

cat > video.json <<'JSON'
{
  "model": "seedance-2.5-lite",
  "mode": "text-to-video",
  "prompt": "A cat walking through a sunny garden, cinematic camera movement",
  "parameters": {
    "duration_seconds": 8,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  },
  "max_cost_credits": 80
}
JSON

curl --fail-with-body "$SEEDANCE_BASE_URL/quotes" \
  -H "Authorization: Bearer $SEEDANCE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @video.json

料金確認は cost_credits を返し、生成や課金は行いません。この Seedance 2.5 Lite の 8 秒リクエストは現在 80 クレジットです。max_cost_credits を超える料金は生成前に拒否されます。

3. 生成を開始

curl --fail-with-body "$SEEDANCE_BASE_URL/videos" \
  -H "Authorization: Bearer $SEEDANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: video-order-0001" \
  --data-binary @video.json

生成ごとに異なる識別子を使用します。タイムアウト時は同じ API キー、識別子、本文で再試行してください。202 レスポンスの id を保存します。

{
  "id": "api_0000000000000000000000000000000000000000000000000000000000000000",
  "model": "seedance-2.5-lite",
  "status": "processing",
  "created_at": "2026-10-03T12:00:00.000Z",
  "credits": {
    "cost": 80
  },
  "outputs": [],
  "error": null
}

4. 状態を確認して保存

curl --fail-with-body "$SEEDANCE_BASE_URL/generations/GENERATION_ID" \
  -H "Authorization: Bearer $SEEDANCE_API_KEY"

GENERATION_ID を返された id に置き換えます。処理中の確認は 10 秒以上空けてください。status が success になったら、expires_at までに outputs[].url を保存します。URL は最大 15 分、ファイルは 14 日間保存されます。

画像生成には画像モデルと text-to-image で POST /images を使用します。参照画像については画像入力.

クイックスタート

1. 認証を設定

2. リクエストと料金を確認

3. 生成を開始

4. 状態を確認して保存

On this page