switch_heading
Seedance 2.5 API ドキュメント
API v3 で Seedance 2.5 と Seedance 2.5 Flash の動画を生成:テキストから動画、参照画像・動画・音声、開始・終了フレーム、動画編集、4K 出力。
API v3 は Seedance 2.5 専用の独立したエンドポイントです。既存の /v1 と /v2 の統合はこれまでどおり動作します。Seedance 2.5 が必要な場合のみ /v3 に切り替えてください。
クイックスタート
| 1 | curl -X POST 'https://seedanceapi.org/v3/generate' \ |
| 2 | -H 'Authorization: Bearer YOUR_API_KEY' \ |
| 3 | -H 'Content-Type: application/json' \ |
| 4 | -d '{ |
| 5 | "model": "seedance-2.5", |
| 6 | "prompt": "A cinematic aerial shot over a coastline at golden hour", |
| 7 | "aspect_ratio": "16:9", |
| 8 | "resolution": "720p", |
| 9 | "duration": 10 |
| 10 | }' |
認証
すべての API リクエストは、Authorization ヘッダーに Bearer トークンが必要です。
重要: API キーはダッシュボードの API Keys ページで取得できます。サーバー上に保管し、ブラウザのコードには絶対に含めないでください。 → API キーを取得
| 1 | Authorization: Bearer YOUR_API_KEY |
生成モード
| モード | 送信するフィールド |
|---|---|
| テキストから動画 | prompt + aspect_ratio |
| 参照生成(画像・動画・音声) | prompt + image_urls / reference_video_urls / reference_audio_urls |
| 開始 / 終了フレーム | prompt + first_frame_url (+ last_frame_url) |
| 動画編集 | prompt + reference_video_urls (1) + duration: -1 + aspect_ratio: "adaptive" |
料金(クレジット)
クレジットは動画の秒単位で課金され、モデル、解像度、参照動画の有無によって変わります。金額はタスク作成時に差し引かれ、失敗した場合は自動的に返金されます。
クレジットをチャージしますか? → 料金ページでチャージ. 1 USD = 100 クレジット。
Seedance 2.5
最高画質。480p、720p、ネイティブ 4K に対応。
| 解像度 | 入力 | レート | 例 |
|---|---|---|---|
| 480p | テキスト / 画像 / 音声 | 28 クレジット / 秒 | 出力 10 秒 = 280 クレジット |
| 480p | 参照動画あり | 17 クレジット / 秒 | 参照 5 秒 + 出力 10 秒 = 255 クレジット |
| 720p | テキスト / 画像 / 音声 | 63 クレジット / 秒 | 出力 10 秒 = 630 クレジット |
| 720p | 参照動画あり | 38 クレジット / 秒 | 参照 5 秒 + 出力 10 秒 = 570 クレジット |
| 4k | テキスト / 画像 / 音声 | 251 クレジット / 秒 | 出力 10 秒 = 2510 クレジット |
| 4k | 参照動画あり | 155 クレジット / 秒 | 参照 5 秒 + 出力 10 秒 = 2325 クレジット |
Seedance 2.5 Flash
より高速で低価格。480p と 720p に対応。
| 解像度 | 入力 | レート | 例 |
|---|---|---|---|
| 480p | テキスト / 画像 / 音声 | 18.5 クレジット / 秒 | 出力 10 秒 = 185 クレジット |
| 480p | 参照動画あり | 11.5 クレジット / 秒 | 参照 5 秒 + 出力 10 秒 = 173 クレジット |
| 720p | テキスト / 画像 / 音声 | 41 クレジット / 秒 | 出力 10 秒 = 410 クレジット |
| 720p | 参照動画あり | 25.5 クレジット / 秒 | 参照 5 秒 + 出力 10 秒 = 383 クレジット |
reference_video_urls を送る場合、参照動画の秒数には低めの動画入力レートが適用され、出力秒数が加算されます。動画編集(duration -1)は入力動画の長さの 2 倍で課金されます。合計はクレジット単位に切り上げられます。
API エンドポイント
/v3/generateSeedance 2.5 または Seedance 2.5 Flash のジョブを開始します。呼び出しはすぐに task_id を返します。/v3/status をポーリングするか、callback_url を渡して結果を取得してください。
リクエストボディ
テキストプロンプト(必須、最大 5000 文字)。
seedance-2.5(デフォルト)または seedance-2.5-flash。 Defaults to seedance-2.5.
出力の長さ(秒):4 から 30 までの任意の整数。動画編集では -1 を使用し、出力は入力動画と同じ長さになります。 Defaults to 5.
Seedance 2.5:480p、720p、4k。Seedance 2.5 Flash:480p または 720p。1080p は利用できません。 Defaults to 720p.
16:9、9:16、4:3、3:4、adaptive。動画編集では adaptive が必須です。 Defaults to 16:9.
参照画像 URL を最大 4 件(http/https)。各画像の使い方をプロンプトで説明してください。
開始フレームとして使用する画像 URL。image_urls、reference_video_urls、reference_audio_urls と併用できません。
終了フレームとして使用する画像 URL(任意)。first_frame_url が必要です。
参照動画 URL を最大 3 件、合計 30 秒まで。動画編集では 4 秒から 30 秒の動画をちょうど 1 件送信してください。
参照音声 URL を最大 3 件。例:音楽やボイストラック。
動画と一緒にサウンドトラックを生成します。 Defaults to true.
プロンプト内の被写体について、モデルがウェブを検索できるようにします。 Defaults to false.
タスク完了時に呼び出される Webhook(任意、公開 URL。localhost は不可)。
任意:結果を公開ギャラリーに表示することを許可します。
テキストから動画
| 1 | { |
| 2 | "model": "seedance-2.5", |
| 3 | "prompt": "A slow dolly shot through a neon-lit street in the rain", |
| 4 | "aspect_ratio": "16:9", |
| 5 | "resolution": "720p", |
| 6 | "duration": 10 |
| 7 | } |
参照画像 + 音声
| 1 | { |
| 2 | "model": "seedance-2.5", |
| 3 | "prompt": "The woman in the reference image dances to the beat of the reference audio in a sunlit studio", |
| 4 | "image_urls": ["https://example.com/character.jpg"], |
| 5 | "reference_audio_urls": ["https://example.com/beat.mp3"], |
| 6 | "aspect_ratio": "9:16", |
| 7 | "resolution": "720p", |
| 8 | "duration": 8 |
| 9 | } |
開始・終了フレーム(Flash)
| 1 | { |
| 2 | "model": "seedance-2.5-flash", |
| 3 | "prompt": "The flower bud slowly opens into full bloom", |
| 4 | "first_frame_url": "https://example.com/bud.jpg", |
| 5 | "last_frame_url": "https://example.com/bloom.jpg", |
| 6 | "resolution": "480p", |
| 7 | "duration": 6 |
| 8 | } |
動画編集
| 1 | { |
| 2 | "model": "seedance-2.5", |
| 3 | "prompt": "Change the season to winter with falling snow; keep the camera motion", |
| 4 | "reference_video_urls": ["https://example.com/input-12s.mp4"], |
| 5 | "aspect_ratio": "adaptive", |
| 6 | "duration": -1, |
| 7 | "resolution": "720p" |
| 8 | } |
4K 出力
| 1 | { |
| 2 | "model": "seedance-2.5", |
| 3 | "prompt": "Macro shot of morning dew rolling off a green leaf", |
| 4 | "aspect_ratio": "16:9", |
| 5 | "resolution": "4k", |
| 6 | "duration": 5 |
| 7 | } |
レスポンス
Task created
| 1 | { |
| 2 | "code": 200, |
| 3 | "message": "success", |
| 4 | "data": { |
| 5 | "task_id": "n90a1b2c3d4e5f6sd25", |
| 6 | "status": "IN_PROGRESS", |
| 7 | "consumed_credits": 630 |
| 8 | } |
| 9 | } |
/v3/statusstatus が SUCCESS または FAILED になるまで task_id でポーリングします。ここで返されるのは /v3/generate で作成されたタスクのみです。
クエリパラメータ
POST /v3/generate が返すタスク ID(sd25 で終わる)。
リクエスト例
| 1 | curl -X GET 'https://seedanceapi.org/v3/status?task_id=n90a1b2c3d4e5f6sd25' \ |
| 2 | -H 'Authorization: Bearer YOUR_API_KEY' |
Tip: status が SUCCESS の場合、data.response は動画 URL の配列です。最初の URL には data.response[0] を使ってください。保存が必要な場合はファイルをダウンロードしてください。
| 1 | const videoUrl = data.response[0]; |
レスポンス
| 1 | { |
| 2 | "code": 200, |
| 3 | "message": "success", |
| 4 | "data": { |
| 5 | "task_id": "n90a1b2c3d4e5f6sd25", |
| 6 | "status": "SUCCESS", |
| 7 | "consumed_credits": 630, |
| 8 | "created_at": "2026-11-19T10:30:00Z", |
| 9 | "type": "seedance-2.5-t2v", |
| 10 | "request": { |
| 11 | "model": "seedance-2.5", |
| 12 | "prompt": "A slow dolly shot…", |
| 13 | "aspect_ratio": "16:9", |
| 14 | "duration": 10 |
| 15 | }, |
| 16 | "response": [ |
| 17 | "https://cdn.example.com/videos/n90a1b2c3d4e5f6sd25.mp4" |
| 18 | ], |
| 19 | "error_message": null |
| 20 | } |
| 21 | } |
API プレイグラウンド
ブラウザで API を試せます。YOUR_API_KEY を実際のキーに置き換えてください。成功した呼び出しはすべて課金されます。
エラーコード
| Status | 発生条件 |
|---|---|
| 400 不正なリクエスト | パラメータが欠落しているか無効です。例:サポートされていない model、resolution、aspect_ratio、duration、メディア URL など。メッセージにどれかが示されます。 |
| 401 認証エラー | API キーがないか無効です。 |
| 402 | このタスクに必要なクレジットが不足しています。 |
| 404 見つかりません | タスクが存在しないか、/v3/generate で作成されたものではありません。 |
| 500 サーバー内部エラー | サーバーエラーです。後で再試行してください。失敗したタスクは自動的に返金されます。 |