API ドキュメント

接続先と認証

Base URL は https://seedance2-5.com/api/v1 です。OpenAPI 仕様と英語の詳細ドキュメントをご参照ください。

設定 → API キーで新しいキーを発行し、Authorization: Bearer YOUR_API_KEY に設定します。API 公開前に発行したキーは作り直してください。古いキーは 403 api_key_upgrade_required を返します。新しいキーは暗号学的乱数を使用し、一度だけ表示されます。有効なキーは最大 10 個、発行は 1 時間に 10 個・1 日に 20 個です。サーバーから呼び出してください。ブラウザーからの呼び出しは許可されません。

動画と画像の生成には有効な有料プラン、または未使用の購入クレジットが必要です。ウェブサイトと同じ残高を使用します。

モデル

動画: Seedance 2.5、Seedance 2.5 Lite、Seedance 2.0 Pro / Fast / Mini、Seedance 1.5 Pro、Kling 3.0、Veo 3.1 fast。

画像: GPT Image 2、Nano Banana 2、Nano Banana Pro。

GET /models でモデル ID、対応するモード、解像度、秒数、アスペクト比、入力枚数を確認できます。

動画生成の例

curl https://seedance2-5.com/api/v1/videos \
  -H "Authorization: Bearer $SEEDANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: my-video-request-0001" \
  -d '{"model":"seedance-2.5-lite","mode":"text-to-video","prompt":"A cat walking through a sunny garden","parameters":{"duration_seconds":8,"resolution":"720p","aspect_ratio":"16:9"},"max_cost_credits":80}'

202 のレスポンスにある id を使い、同じ API キーで GET /generations/{id} を呼び出します。処理中は 10 秒以上の間隔を空けてください。status が success になったら outputs[].url をダウンロードします。URL の有効期限は最大 15 分です。再取得すると新しい URL が発行されます。生成ファイルの保存期間は 14 日です。

タイムアウト時は 同じ API キー、Idempotency-Key、本文 で再送してください。本文を変更すると 409 になります。受付が確認できない場合は、元の ID を確認しながらサポートへご連絡ください。

画像入力と料金

画像入力は、POST /uploads でアップロード URL を取得し、指定されたヘッダーと正確なバイト数で PUT した後、POST /uploads/complete に asset_ids を送って確認します。返された URL を inputs に指定してください。他アカウントの画像や外部 URL は使用できません。

GET /credits/balance で残高、POST /quotes で生成前の料金を確認できます。Seedance 2.5 Lite は出力 1 秒あたり 10 クレジットです。参照画像は最初の 5 枚まで含まれ、追加 1 枚につき 7 クレジットです。画像生成は POST /images を使用します。

初期制限

全 API キーで共有されるアカウント単位の制限です。

• 同時生成: 1 件。生成・アップロード操作: 10 回/分、1,000 回/日。
• 読み取り・料金見積もり: 60 回/分、20,000 回/日。処理中の同じ生成 ID は 10 秒に 1 回。
• API 生成予算: 2,000 クレジット/日。確認済みの失敗も日次予算に含まれます。
• 画像アップロード: 100 ファイル、500 MiB/日。1 ファイル最大 30 MiB。

日次制限は UTC でリセットされます。429 の場合は Retry-After に従ってください。503 の場合は同じリクエスト識別子で再試行してください。IP とサービス全体の制限も適用されます。

お問い合わせ: support@seedance2-5.com。