Seedance 動画 API:モデル、フィールド、素材の要件
BetterToken API Key で Seedance に接続し、Model ID と操作に応じたフィールド、素材、生成方法を選びます。
テキスト、先頭フレーム、参照素材から動画を生成できます。中国リージョンの 4 モデルは 3 種類の生成操作に対応し、SR の 2 モデルはテキストからの動画生成と先頭フレーム 1 枚からの動画生成に対応します。必要な操作、長さ、出力設定に応じて Model ID を選んでください。
まず BetterToken API Key を用意してください。Base URL は https://bettertoken.ai/v1、認証は Authorization: Bearer YOUR_API_KEY です。Model ID は大文字・小文字も含めて、そのままコピーしてください。
以下の各 request.json は同じ手順で使います。まず見積もりを取得し、確認後に作成、ポーリング、ダウンロードを行います。見積もりでは生成を開始しません。作成すると有料タスクを送信します。現在の料金はモデル広場で確認してください。
モデルと操作
以下の表は操作別の選択肢です。フィールドのデフォルト値、素材数、組み合わせの制約は各節を参照してください。素材サイズは 1 MB = 1048576 バイトで換算しています。
| Model ID | 操作 | 長さ(秒) | 出力設定 | アスペクト比 | 音声 | 素材の役割 |
|---|---|---|---|---|---|---|
ByteDance-Seedance-2.0-SR | image_to_video | 5–10、5 刻み | 720p、1080p、4k | 16:9、4:3、1:1、3:4、9:16、21:9、adaptive | on、off | first_frame |
ByteDance-Seedance-2.0-SR | text_to_video | 5–10、5 刻み | 720p、1080p、4k | 16:9、4:3、1:1、3:4、9:16、21:9、adaptive | on、off | なし |
ByteDance-Seedance-2.5-SR | image_to_video | 5–10、5 刻み | 720p、1080p | 16:9、4:3、1:1、3:4、9:16、21:9、adaptive | on、off | first_frame |
ByteDance-Seedance-2.5-SR | text_to_video | 5–10、5 刻み | 720p、1080p | 16:9、4:3、1:1、3:4、9:16、21:9、adaptive | on、off | なし |
doubao-seedance-2-0-260128 | image_to_video | 4–15、1 刻み。auto も使用可能 | 480p、720p、1080p、4k | 16:9、4:3、1:1、3:4、9:16、21:9、adaptive | on、off | first_frame、last_frame |
doubao-seedance-2-0-260128 | reference_to_video | 4–15、1 刻み。auto も使用可能 | 480p、720p、1080p、4k | 16:9、4:3、1:1、3:4、9:16、21:9、adaptive | on、off | reference_image、reference_video、reference_audio |
doubao-seedance-2-0-260128 | text_to_video | 4–15、1 刻み。auto も使用可能 | 480p、720p、1080p、4k | 16:9、4:3、1:1、3:4、9:16、21:9、adaptive | on、off | なし |
doubao-seedance-2-0-fast-260128 | image_to_video | 4–15、1 刻み。auto も使用可能 | 480p、720p | 16:9、4:3、1:1、3:4、9:16、21:9、adaptive | on、off | first_frame、last_frame |
doubao-seedance-2-0-fast-260128 | reference_to_video | 4–15、1 刻み。auto も使用可能 | 480p、720p | 16:9、4:3、1:1、3:4、9:16、21:9、adaptive | on、off | reference_image、reference_video、reference_audio |
doubao-seedance-2-0-fast-260128 | text_to_video | 4–15、1 刻み。auto も使用可能 | 480p、720p | 16:9、4:3、1:1、3:4、9:16、21:9、adaptive | on、off | なし |
doubao-seedance-2-0-mini-260615 | image_to_video | 4–15、1 刻み。auto も使用可能 | 480p、720p | 16:9、4:3、1:1、3:4、9:16、21:9、adaptive | on、off | first_frame、last_frame |
doubao-seedance-2-0-mini-260615 | reference_to_video | 4–15、1 刻み。auto も使用可能 | 480p、720p | 16:9、4:3、1:1、3:4、9:16、21:9、adaptive | on、off | reference_image、reference_video、reference_audio |
doubao-seedance-2-0-mini-260615 | text_to_video | 4–15、1 刻み。auto も使用可能 | 480p、720p | 16:9、4:3、1:1、3:4、9:16、21:9、adaptive | on、off | なし |
doubao-seedance-2-5-260628 | image_to_video | 4–30、1 刻み。auto も使用可能 | 480p、720p、1080p | adaptive | on、off | first_frame、last_frame |
doubao-seedance-2-5-260628 | reference_to_video | 4–30、1 刻み。auto も使用可能 | 480p、720p、1080p | 16:9、4:3、1:1、3:4、9:16、21:9、adaptive | on、off | reference_image、reference_video、reference_audio |
doubao-seedance-2-5-260628 | text_to_video | 4–30、1 刻み。auto も使用可能 | 480p、720p、1080p | 16:9、4:3、1:1、3:4、9:16、21:9、adaptive | on、off | なし |
SR の 2 モデルの固定長は 5 秒または 10 秒のみです。中国リージョンと SR のモデルは Model ID が異なります。別のモデルのフィールドや素材制限を流用しないでください。
サンプル素材
画像からの動画生成と画像参照の例には、白いテーブルの上にある青い陶器のマグカップを使います。そのまま試すか、自分に使用権があり、このページの制限を満たす公開 HTTPS 素材に置き換えてください。

テキストから動画を生成する
ByteDance-Seedance-2.0-SR
テキストの説明だけで動画を生成したい場合に使います。
model にこの節の Model ID、operation に text_to_video を設定します。生成フィールドは以下の表にあるものだけを使い、素材は media 配列に入れてください。
| フィールド | 型 | 必須 | 選択肢または範囲 | デフォルト |
|---|---|---|---|---|
audio.mode | string | いいえ | on、off | on |
duration.mode | string | いいえ | fixed | fixed |
duration.seconds | integer | いいえ | 5–10、5 秒刻み。固定長の場合のみ | 5 |
output.aspect_ratio | string | いいえ | 16:9、4:3、1:1、3:4、9:16、21:9、adaptive | 16:9 |
output.format | string | いいえ | mp4 | mp4 |
output.resolution | string | いいえ | 720p、1080p、4k | 720p |
prompt | string | はい | 文字列 | なし |
watermark | boolean | いいえ | false | false |
素材の要件
この操作は素材を受け付けません。
組み合わせの制約
duration.mode="fixed"ではduration.secondsが必須です。fixedを明示する場合は秒数も指定してください。
リクエスト例
以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。
{ "model": "ByteDance-Seedance-2.0-SR", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}よくある 422 エラー
| 422 エラーコード | 対処方法 |
|---|---|
enum / range / step | この節のフィールド表に従って値と刻み幅を調整する。 |
unsupported_field | この操作のフィールド表にないフィールドを削除する。 |
requires | この節の組み合わせ制約に従って秒数、アスペクト比、音声設定、素材を補う。 |
ByteDance-Seedance-2.5-SR
テキストの説明だけで動画を生成したい場合に使います。
model にこの節の Model ID、operation に text_to_video を設定します。生成フィールドは以下の表にあるものだけを使い、素材は media 配列に入れてください。
| フィールド | 型 | 必須 | 選択肢または範囲 | デフォルト |
|---|---|---|---|---|
audio.mode | string | いいえ | on、off | on |
duration.mode | string | いいえ | fixed | fixed |
duration.seconds | integer | いいえ | 5–10、5 秒刻み。固定長の場合のみ | 5 |
output.aspect_ratio | string | いいえ | 16:9、4:3、1:1、3:4、9:16、21:9、adaptive | 16:9 |
output.format | string | いいえ | mp4 | mp4 |
output.resolution | string | いいえ | 720p、1080p | 720p |
prompt | string | はい | 文字列 | なし |
watermark | boolean | いいえ | false | false |
素材の要件
この操作は素材を受け付けません。
組み合わせの制約
duration.mode="fixed"ではduration.secondsが必須です。fixedを明示する場合は秒数も指定してください。
リクエスト例
以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。
{ "model": "ByteDance-Seedance-2.5-SR", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}よくある 422 エラー
| 422 エラーコード | 対処方法 |
|---|---|
enum / range / step | この節のフィールド表に従って値と刻み幅を調整する。 |
unsupported_field | この操作のフィールド表にないフィールドを削除する。 |
requires | この節の組み合わせ制約に従って秒数、アスペクト比、音声設定、素材を補う。 |
doubao-seedance-2-0-260128
テキストの説明だけで動画を生成したい場合に使います。
model にこの節の Model ID、operation に text_to_video を設定します。生成フィールドは以下の表にあるものだけを使い、素材は media 配列に入れてください。
| フィールド | 型 | 必須 | 選択肢または範囲 | デフォルト |
|---|---|---|---|---|
audio.mode | string | いいえ | on、off | on |
duration.mode | string | いいえ | fixed、auto | fixed |
duration.seconds | integer | いいえ | 4–15、1 秒刻み。固定長の場合のみ | なし |
output.aspect_ratio | string | いいえ | 16:9、4:3、1:1、3:4、9:16、21:9、adaptive | adaptive |
output.format | string | いいえ | mp4 | mp4 |
output.resolution | string | いいえ | 480p、720p、1080p、4k | 720p |
prompt | string | はい | 文字列 | なし |
watermark | boolean | いいえ | false、true | false |
素材の要件
この操作は素材を受け付けません。
組み合わせの制約
duration.mode="fixed"ではduration.secondsが必須です。fixedを明示する場合は秒数も指定してください。duration.mode="auto"を使う場合はduration.secondsを送らないでください。
リクエスト例
以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。
{ "model": "doubao-seedance-2-0-260128", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}よくある 422 エラー
| 422 エラーコード | 対処方法 |
|---|---|
enum / range / step | この節のフィールド表に従って値と刻み幅を調整する。 |
unsupported_field | この操作のフィールド表にないフィールドを削除する。 |
requires | この節の組み合わせ制約に従って秒数、アスペクト比、音声設定、素材を補う。 |
excludes | 自動の長さや末尾フレームと競合するフィールドを削除する。 |
doubao-seedance-2-0-fast-260128
テキストの説明だけで動画を生成したい場合に使います。
model にこの節の Model ID、operation に text_to_video を設定します。生成フィールドは以下の表にあるものだけを使い、素材は media 配列に入れてください。
| フィールド | 型 | 必須 | 選択肢または範囲 | デフォルト |
|---|---|---|---|---|
audio.mode | string | いいえ | on、off | on |
duration.mode | string | いいえ | fixed、auto | fixed |
duration.seconds | integer | いいえ | 4–15、1 秒刻み。固定長の場合のみ | なし |
output.aspect_ratio | string | いいえ | 16:9、4:3、1:1、3:4、9:16、21:9、adaptive | adaptive |
output.format | string | いいえ | mp4 | mp4 |
output.resolution | string | いいえ | 480p、720p | 720p |
prompt | string | はい | 文字列 | なし |
watermark | boolean | いいえ | false、true | false |
素材の要件
この操作は素材を受け付けません。
組み合わせの制約
duration.mode="fixed"ではduration.secondsが必須です。fixedを明示する場合は秒数も指定してください。duration.mode="auto"を使う場合はduration.secondsを送らないでください。
リクエスト例
以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。
{ "model": "doubao-seedance-2-0-fast-260128", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}よくある 422 エラー
| 422 エラーコード | 対処方法 |
|---|---|
enum / range / step | この節のフィールド表に従って値と刻み幅を調整する。 |
unsupported_field | この操作のフィールド表にないフィールドを削除する。 |
requires | この節の組み合わせ制約に従って秒数、アスペクト比、音声設定、素材を補う。 |
excludes | 自動の長さや末尾フレームと競合するフィールドを削除する。 |
doubao-seedance-2-0-mini-260615
テキストの説明だけで動画を生成したい場合に使います。
model にこの節の Model ID、operation に text_to_video を設定します。生成フィールドは以下の表にあるものだけを使い、素材は media 配列に入れてください。
| フィールド | 型 | 必須 | 選択肢または範囲 | デフォルト |
|---|---|---|---|---|
audio.mode | string | いいえ | on、off | on |
duration.mode | string | いいえ | fixed、auto | fixed |
duration.seconds | integer | いいえ | 4–15、1 秒刻み。固定長の場合のみ | なし |
output.aspect_ratio | string | いいえ | 16:9、4:3、1:1、3:4、9:16、21:9、adaptive | adaptive |
output.format | string | いいえ | mp4 | mp4 |
output.resolution | string | いいえ | 480p、720p | 720p |
prompt | string | はい | 文字列 | なし |
watermark | boolean | いいえ | false、true | false |
素材の要件
この操作は素材を受け付けません。
組み合わせの制約
duration.mode="fixed"ではduration.secondsが必須です。fixedを明示する場合は秒数も指定してください。duration.mode="auto"を使う場合はduration.secondsを送らないでください。
リクエスト例
以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。
{ "model": "doubao-seedance-2-0-mini-260615", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}よくある 422 エラー
| 422 エラーコード | 対処方法 |
|---|---|
enum / range / step | この節のフィールド表に従って値と刻み幅を調整する。 |
unsupported_field | この操作のフィールド表にないフィールドを削除する。 |
requires | この節の組み合わせ制約に従って秒数、アスペクト比、音声設定、素材を補う。 |
excludes | 自動の長さや末尾フレームと競合するフィールドを削除する。 |
doubao-seedance-2-5-260628
テキストの説明だけで動画を生成したい場合に使います。
model にこの節の Model ID、operation に text_to_video を設定します。生成フィールドは以下の表にあるものだけを使い、素材は media 配列に入れてください。
| フィールド | 型 | 必須 | 選択肢または範囲 | デフォルト |
|---|---|---|---|---|
audio.mode | string | いいえ | on、off | on |
duration.mode | string | いいえ | fixed、auto | auto |
duration.seconds | integer | いいえ | 4–30、1 秒刻み。固定長の場合のみ | なし |
output.aspect_ratio | string | いいえ | 16:9、4:3、1:1、3:4、9:16、21:9、adaptive | adaptive |
output.format | string | いいえ | mp4 | mp4 |
output.resolution | string | いいえ | 480p、720p、1080p | 720p |
prompt | string | はい | 文字列 | なし |
watermark | boolean | いいえ | false、true | false |
素材の要件
この操作は素材を受け付けません。
組み合わせの制約
duration.mode="fixed"ではduration.secondsが必須です。fixedを明示する場合は秒数も指定してください。duration.mode="auto"を使う場合はduration.secondsを送らないでください。
リクエスト例
以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。
{ "model": "doubao-seedance-2-5-260628", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}よくある 422 エラー
| 422 エラーコード | 対処方法 |
|---|---|
enum / range / step | この節のフィールド表に従って値と刻み幅を調整する。 |
unsupported_field | この操作のフィールド表にないフィールドを削除する。 |
requires | この節の組み合わせ制約に従って秒数、アスペクト比、音声設定、素材を補う。 |
excludes | 自動の長さや末尾フレームと競合するフィールドを削除する。 |
画像から動画を生成する
ByteDance-Seedance-2.0-SR
画像で開始画面、または開始・終了画面を指定したい場合に使います。
model にこの節の Model ID、operation に image_to_video を設定します。生成フィールドは以下の表にあるものだけを使い、素材は media 配列に入れてください。
| フィールド | 型 | 必須 | 選択肢または範囲 | デフォルト |
|---|---|---|---|---|
audio.mode | string | いいえ | on、off | on |
duration.mode | string | いいえ | fixed | fixed |
duration.seconds | integer | いいえ | 5–10、5 秒刻み。固定長の場合のみ | 5 |
output.aspect_ratio | string | いいえ | 16:9、4:3、1:1、3:4、9:16、21:9、adaptive | 16:9 |
output.format | string | いいえ | mp4 | mp4 |
output.resolution | string | いいえ | 720p、1080p、4k | 720p |
prompt | string | はい | 文字列 | なし |
watermark | boolean | いいえ | false | false |
素材の要件
| 素材の役割 | 種類と数 | 形式 | ファイルごとの制限 |
|---|---|---|---|
first_frame | image、1 個(必須) | jpeg、png、webp | サイズ上限 10 MB。幅 128–4096 px。高さ 128–4096 px |
素材が必須かどうかは、以下の組み合わせ制約にも従ってください。
組み合わせの制約
duration.mode="fixed"ではduration.secondsが必須です。fixedを明示する場合は秒数も指定してください。first_frameは必須です。
リクエスト例
以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。
{ "model": "ByteDance-Seedance-2.0-SR", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}よくある 422 エラー
| 422 エラーコード | 対処方法 |
|---|---|
enum / range / step | この節のフィールド表に従って値と刻み幅を調整する。 |
unsupported_field | この操作のフィールド表にないフィールドを削除する。 |
requires | この節の組み合わせ制約に従って秒数、アスペクト比、音声設定、素材を補う。 |
count / media_role | この節の素材表に従って役割と数を調整する。 |
video_input_unsupported | 公開 HTTPS URL、Content-Type、ファイル形式を確認し、再度見積もりを取得する。 |
ByteDance-Seedance-2.5-SR
画像で開始画面、または開始・終了画面を指定したい場合に使います。
model にこの節の Model ID、operation に image_to_video を設定します。生成フィールドは以下の表にあるものだけを使い、素材は media 配列に入れてください。
| フィールド | 型 | 必須 | 選択肢または範囲 | デフォルト |
|---|---|---|---|---|
audio.mode | string | いいえ | on、off | on |
duration.mode | string | いいえ | fixed | fixed |
duration.seconds | integer | いいえ | 5–10、5 秒刻み。固定長の場合のみ | 5 |
output.aspect_ratio | string | いいえ | 16:9、4:3、1:1、3:4、9:16、21:9、adaptive | 16:9 |
output.format | string | いいえ | mp4 | mp4 |
output.resolution | string | いいえ | 720p、1080p | 720p |
prompt | string | はい | 文字列 | なし |
watermark | boolean | いいえ | false | false |
素材の要件
| 素材の役割 | 種類と数 | 形式 | ファイルごとの制限 |
|---|---|---|---|
first_frame | image、1 個(必須) | jpeg、png、webp | サイズ上限 10 MB。幅 128–4096 px。高さ 128–4096 px |
素材が必須かどうかは、以下の組み合わせ制約にも従ってください。
組み合わせの制約
duration.mode="fixed"ではduration.secondsが必須です。fixedを明示する場合は秒数も指定してください。first_frameは必須です。
リクエスト例
以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。
{ "model": "ByteDance-Seedance-2.5-SR", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}よくある 422 エラー
| 422 エラーコード | 対処方法 |
|---|---|
enum / range / step | この節のフィールド表に従って値と刻み幅を調整する。 |
unsupported_field | この操作のフィールド表にないフィールドを削除する。 |
requires | この節の組み合わせ制約に従って秒数、アスペクト比、音声設定、素材を補う。 |
count / media_role | この節の素材表に従って役割と数を調整する。 |
video_input_unsupported | 公開 HTTPS URL、Content-Type、ファイル形式を確認し、再度見積もりを取得する。 |
doubao-seedance-2-0-260128
画像で開始画面、または開始・終了画面を指定したい場合に使います。
model にこの節の Model ID、operation に image_to_video を設定します。生成フィールドは以下の表にあるものだけを使い、素材は media 配列に入れてください。
| フィールド | 型 | 必須 | 選択肢または範囲 | デフォルト |
|---|---|---|---|---|
audio.mode | string | いいえ | on、off | on |
duration.mode | string | いいえ | fixed、auto | fixed |
duration.seconds | integer | いいえ | 4–15、1 秒刻み。固定長の場合のみ | なし |
output.aspect_ratio | string | いいえ | 16:9、4:3、1:1、3:4、9:16、21:9、adaptive | adaptive |
output.format | string | いいえ | mp4 | mp4 |
output.resolution | string | いいえ | 480p、720p、1080p、4k | 720p |
prompt | string | はい | 文字列 | なし |
watermark | boolean | いいえ | false、true | false |
素材の要件
| 素材の役割 | 種類と数 | 形式 | ファイルごとの制限 |
|---|---|---|---|
first_frame | image、1 個(必須) | jpeg、png、webp、bmp、tiff、gif、heic、heif | サイズ 1–31457279 バイト。幅 300–6000 px。高さ 300–6000 px |
last_frame | image、任意、最大 1 個 | jpeg、png、webp、bmp、tiff、gif、heic、heif | サイズ 1–31457279 バイト。幅 300–6000 px。高さ 300–6000 px |
素材が必須かどうかは、以下の組み合わせ制約にも従ってください。
組み合わせの制約
duration.mode="fixed"ではduration.secondsが必須です。fixedを明示する場合は秒数も指定してください。duration.mode="auto"を使う場合はduration.secondsを送らないでください。first_frameは必須です。
リクエスト例
以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。
{ "model": "doubao-seedance-2-0-260128", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}よくある 422 エラー
| 422 エラーコード | 対処方法 |
|---|---|
enum / range / step | この節のフィールド表に従って値と刻み幅を調整する。 |
unsupported_field | この操作のフィールド表にないフィールドを削除する。 |
requires | この節の組み合わせ制約に従って秒数、アスペクト比、音声設定、素材を補う。 |
excludes | 自動の長さや末尾フレームと競合するフィールドを削除する。 |
count / media_role | この節の素材表に従って役割と数を調整する。 |
video_input_unsupported | 公開 HTTPS URL、Content-Type、ファイル形式を確認し、再度見積もりを取得する。 |
doubao-seedance-2-0-fast-260128
画像で開始画面、または開始・終了画面を指定したい場合に使います。
model にこの節の Model ID、operation に image_to_video を設定します。生成フィールドは以下の表にあるものだけを使い、素材は media 配列に入れてください。
| フィールド | 型 | 必須 | 選択肢または範囲 | デフォルト |
|---|---|---|---|---|
audio.mode | string | いいえ | on、off | on |
duration.mode | string | いいえ | fixed、auto | fixed |
duration.seconds | integer | いいえ | 4–15、1 秒刻み。固定長の場合のみ | なし |
output.aspect_ratio | string | いいえ | 16:9、4:3、1:1、3:4、9:16、21:9、adaptive | adaptive |
output.format | string | いいえ | mp4 | mp4 |
output.resolution | string | いいえ | 480p、720p | 720p |
prompt | string | はい | 文字列 | なし |
watermark | boolean | いいえ | false、true | false |
素材の要件
| 素材の役割 | 種類と数 | 形式 | ファイルごとの制限 |
|---|---|---|---|
first_frame | image、1 個(必須) | jpeg、png、webp、bmp、tiff、gif、heic、heif | サイズ 1–31457279 バイト。幅 300–6000 px。高さ 300–6000 px |
last_frame | image、任意、最大 1 個 | jpeg、png、webp、bmp、tiff、gif、heic、heif | サイズ 1–31457279 バイト。幅 300–6000 px。高さ 300–6000 px |
素材が必須かどうかは、以下の組み合わせ制約にも従ってください。
組み合わせの制約
duration.mode="fixed"ではduration.secondsが必須です。fixedを明示する場合は秒数も指定してください。duration.mode="auto"を使う場合はduration.secondsを送らないでください。first_frameは必須です。
リクエスト例
以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。
{ "model": "doubao-seedance-2-0-fast-260128", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}よくある 422 エラー
| 422 エラーコード | 対処方法 |
|---|---|
enum / range / step | この節のフィールド表に従って値と刻み幅を調整する。 |
unsupported_field | この操作のフィールド表にないフィールドを削除する。 |
requires | この節の組み合わせ制約に従って秒数、アスペクト比、音声設定、素材を補う。 |
excludes | 自動の長さや末尾フレームと競合するフィールドを削除する。 |
count / media_role | この節の素材表に従って役割と数を調整する。 |
video_input_unsupported | 公開 HTTPS URL、Content-Type、ファイル形式を確認し、再度見積もりを取得する。 |
doubao-seedance-2-0-mini-260615
画像で開始画面、または開始・終了画面を指定したい場合に使います。
model にこの節の Model ID、operation に image_to_video を設定します。生成フィールドは以下の表にあるものだけを使い、素材は media 配列に入れてください。
| フィールド | 型 | 必須 | 選択肢または範囲 | デフォルト |
|---|---|---|---|---|
audio.mode | string | いいえ | on、off | on |
duration.mode | string | いいえ | fixed、auto | fixed |
duration.seconds | integer | いいえ | 4–15、1 秒刻み。固定長の場合のみ | なし |
output.aspect_ratio | string | いいえ | 16:9、4:3、1:1、3:4、9:16、21:9、adaptive | adaptive |
output.format | string | いいえ | mp4 | mp4 |
output.resolution | string | いいえ | 480p、720p | 720p |
prompt | string | はい | 文字列 | なし |
watermark | boolean | いいえ | false、true | false |
素材の要件
| 素材の役割 | 種類と数 | 形式 | ファイルごとの制限 |
|---|---|---|---|
first_frame | image、1 個(必須) | jpeg、png、webp、bmp、tiff、gif、heic、heif | サイズ 1–31457279 バイト。幅 300–6000 px。高さ 300–6000 px |
last_frame | image、任意、最大 1 個 | jpeg、png、webp、bmp、tiff、gif、heic、heif | サイズ 1–31457279 バイト。幅 300–6000 px。高さ 300–6000 px |
素材が必須かどうかは、以下の組み合わせ制約にも従ってください。
組み合わせの制約
duration.mode="fixed"ではduration.secondsが必須です。fixedを明示する場合は秒数も指定してください。duration.mode="auto"を使う場合はduration.secondsを送らないでください。first_frameは必須です。
リクエスト例
以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。
{ "model": "doubao-seedance-2-0-mini-260615", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}よくある 422 エラー
| 422 エラーコード | 対処方法 |
|---|---|
enum / range / step | この節のフィールド表に従って値と刻み幅を調整する。 |
unsupported_field | この操作のフィールド表にないフィールドを削除する。 |
requires | この節の組み合わせ制約に従って秒数、アスペクト比、音声設定、素材を補う。 |
excludes | 自動の長さや末尾フレームと競合するフィールドを削除する。 |
count / media_role | この節の素材表に従って役割と数を調整する。 |
video_input_unsupported | 公開 HTTPS URL、Content-Type、ファイル形式を確認し、再度見積もりを取得する。 |
doubao-seedance-2-5-260628
画像で開始画面、または開始・終了画面を指定したい場合に使います。
model にこの節の Model ID、operation に image_to_video を設定します。生成フィールドは以下の表にあるものだけを使い、素材は media 配列に入れてください。
| フィールド | 型 | 必須 | 選択肢または範囲 | デフォルト |
|---|---|---|---|---|
audio.mode | string | いいえ | on、off | on |
duration.mode | string | いいえ | fixed、auto | auto |
duration.seconds | integer | いいえ | 4–30、1 秒刻み。固定長の場合のみ | なし |
output.aspect_ratio | string | いいえ | adaptive | adaptive |
output.format | string | いいえ | mp4 | mp4 |
output.resolution | string | いいえ | 480p、720p、1080p | 720p |
prompt | string | はい | 文字列 | なし |
watermark | boolean | いいえ | false、true | false |
素材の要件
| 素材の役割 | 種類と数 | 形式 | ファイルごとの制限 |
|---|---|---|---|
first_frame | image、1 個(必須) | jpeg、png、webp、bmp、tiff、gif、heic、heif | サイズ 1–31457279 バイト。幅 300–6000 px。高さ 300–6000 px |
last_frame | image、任意、最大 1 個 | jpeg、png、webp、bmp、tiff、gif、heic、heif | サイズ 1–31457279 バイト。幅 300–6000 px。高さ 300–6000 px |
素材が必須かどうかは、以下の組み合わせ制約にも従ってください。
組み合わせの制約
duration.mode="fixed"ではduration.secondsが必須です。fixedを明示する場合は秒数も指定してください。duration.mode="auto"を使う場合はduration.secondsを送らないでください。first_frameは必須です。- この操作では、先頭フレームのみの場合も先頭・末尾フレーム両方の場合も、
output.aspect_ratio="adaptive"が必須です。
リクエスト例
以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。
{ "model": "doubao-seedance-2-5-260628", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}よくある 422 エラー
| 422 エラーコード | 対処方法 |
|---|---|
enum / range / step | この節のフィールド表に従って値と刻み幅を調整する。 |
unsupported_field | この操作のフィールド表にないフィールドを削除する。 |
requires | この節の組み合わせ制約に従って秒数、アスペクト比、音声設定、素材を補う。 |
excludes | 自動の長さや末尾フレームと競合するフィールドを削除する。 |
count / media_role | この節の素材表に従って役割と数を調整する。 |
video_input_unsupported | 公開 HTTPS URL、Content-Type、ファイル形式を確認し、再度見積もりを取得する。 |
参照素材から生成する
doubao-seedance-2-0-260128
参照素材で被写体や動作の特徴を保ちたい場合に使います。
model にこの節の Model ID、operation に reference_to_video を設定します。生成フィールドは以下の表にあるものだけを使い、素材は media 配列に入れてください。
| フィールド | 型 | 必須 | 選択肢または範囲 | デフォルト |
|---|---|---|---|---|
audio.mode | string | いいえ | on、off | on |
duration.mode | string | いいえ | fixed、auto | fixed |
duration.seconds | integer | いいえ | 4–15、1 秒刻み。固定長の場合のみ | なし |
output.aspect_ratio | string | いいえ | 16:9、4:3、1:1、3:4、9:16、21:9、adaptive | adaptive |
output.format | string | いいえ | mp4 | mp4 |
output.resolution | string | いいえ | 480p、720p、1080p、4k | 720p |
prompt | string | はい | 文字列 | なし |
watermark | boolean | いいえ | false、true | false |
素材の要件
| 素材の役割 | 種類と数 | 形式 | ファイルごとの制限 |
|---|---|---|---|
reference_image | image、任意、最大 9 個 | jpeg、png、webp、bmp、tiff、gif、heic、heif | サイズ 1–31457279 バイト。幅 300–6000 px。高さ 300–6000 px |
reference_video | video、任意、最大 3 個 | mp4、mov | サイズ上限 200 MB。幅 300–6000 px。高さ 300–6000 px。長さ 2–15 秒。フレームレート下限 24 fps、上限 60 fps。この役割の合計上限 15 秒 |
reference_audio | audio、任意、最大 3 個 | wav、mp3 | サイズ上限 15 MB。長さ 2–15 秒。この役割の合計上限 15 秒 |
素材が必須かどうかは、以下の組み合わせ制約にも従ってください。
組み合わせの制約
duration.mode="fixed"ではduration.secondsが必須です。fixedを明示する場合は秒数も指定してください。duration.mode="auto"を使う場合はduration.secondsを送らないでください。reference_image、reference_video、reference_audioのうち少なくとも 1 つを指定してください。- 参照音声は単独では使えません。参照画像または参照動画も指定してください。
リクエスト例
以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。
{ "model": "doubao-seedance-2-0-260128", "operation": "reference_to_video", "prompt": "Create a product video of the blue ceramic mug in the reference image. Keep its shape and color.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "reference", "type": "image", "role": "reference_image", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}よくある 422 エラー
| 422 エラーコード | 対処方法 |
|---|---|
enum / range / step | この節のフィールド表に従って値と刻み幅を調整する。 |
unsupported_field | この操作のフィールド表にないフィールドを削除する。 |
requires | この節の組み合わせ制約に従って秒数、アスペクト比、音声設定、素材を補う。 |
excludes | 自動の長さや末尾フレームと競合するフィールドを削除する。 |
count / media_role | この節の素材表に従って役割と数を調整する。 |
video_input_unsupported | 公開 HTTPS URL、Content-Type、ファイル形式を確認し、再度見積もりを取得する。 |
doubao-seedance-2-0-fast-260128
参照素材で被写体や動作の特徴を保ちたい場合に使います。
model にこの節の Model ID、operation に reference_to_video を設定します。生成フィールドは以下の表にあるものだけを使い、素材は media 配列に入れてください。
| フィールド | 型 | 必須 | 選択肢または範囲 | デフォルト |
|---|---|---|---|---|
audio.mode | string | いいえ | on、off | on |
duration.mode | string | いいえ | fixed、auto | fixed |
duration.seconds | integer | いいえ | 4–15、1 秒刻み。固定長の場合のみ | なし |
output.aspect_ratio | string | いいえ | 16:9、4:3、1:1、3:4、9:16、21:9、adaptive | adaptive |
output.format | string | いいえ | mp4 | mp4 |
output.resolution | string | いいえ | 480p、720p | 720p |
prompt | string | はい | 文字列 | なし |
watermark | boolean | いいえ | false、true | false |
素材の要件
| 素材の役割 | 種類と数 | 形式 | ファイルごとの制限 |
|---|---|---|---|
reference_image | image、任意、最大 9 個 | jpeg、png、webp、bmp、tiff、gif、heic、heif | サイズ 1–31457279 バイト。幅 300–6000 px。高さ 300–6000 px |
reference_video | video、任意、最大 3 個 | mp4、mov | サイズ上限 200 MB。幅 300–6000 px。高さ 300–6000 px。長さ 2–15 秒。フレームレート下限 24 fps、上限 60 fps。この役割の合計上限 15 秒 |
reference_audio | audio、任意、最大 3 個 | wav、mp3 | サイズ上限 15 MB。長さ 2–15 秒。この役割の合計上限 15 秒 |
素材が必須かどうかは、以下の組み合わせ制約にも従ってください。
組み合わせの制約
duration.mode="fixed"ではduration.secondsが必須です。fixedを明示する場合は秒数も指定してください。duration.mode="auto"を使う場合はduration.secondsを送らないでください。reference_image、reference_video、reference_audioのうち少なくとも 1 つを指定してください。- 参照音声は単独では使えません。参照画像または参照動画も指定してください。
リクエスト例
以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。
{ "model": "doubao-seedance-2-0-fast-260128", "operation": "reference_to_video", "prompt": "Create a product video of the blue ceramic mug in the reference image. Keep its shape and color.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "reference", "type": "image", "role": "reference_image", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}よくある 422 エラー
| 422 エラーコード | 対処方法 |
|---|---|
enum / range / step | この節のフィールド表に従って値と刻み幅を調整する。 |
unsupported_field | この操作のフィールド表にないフィールドを削除する。 |
requires | この節の組み合わせ制約に従って秒数、アスペクト比、音声設定、素材を補う。 |
excludes | 自動の長さや末尾フレームと競合するフィールドを削除する。 |
count / media_role | この節の素材表に従って役割と数を調整する。 |
video_input_unsupported | 公開 HTTPS URL、Content-Type、ファイル形式を確認し、再度見積もりを取得する。 |
doubao-seedance-2-0-mini-260615
参照素材で被写体や動作の特徴を保ちたい場合に使います。
model にこの節の Model ID、operation に reference_to_video を設定します。生成フィールドは以下の表にあるものだけを使い、素材は media 配列に入れてください。
| フィールド | 型 | 必須 | 選択肢または範囲 | デフォルト |
|---|---|---|---|---|
audio.mode | string | いいえ | on、off | on |
duration.mode | string | いいえ | fixed、auto | fixed |
duration.seconds | integer | いいえ | 4–15、1 秒刻み。固定長の場合のみ | なし |
output.aspect_ratio | string | いいえ | 16:9、4:3、1:1、3:4、9:16、21:9、adaptive | adaptive |
output.format | string | いいえ | mp4 | mp4 |
output.resolution | string | いいえ | 480p、720p | 720p |
prompt | string | はい | 文字列 | なし |
watermark | boolean | いいえ | false、true | false |
素材の要件
| 素材の役割 | 種類と数 | 形式 | ファイルごとの制限 |
|---|---|---|---|
reference_image | image、任意、最大 9 個 | jpeg、png、webp、bmp、tiff、gif、heic、heif | サイズ 1–31457279 バイト。幅 300–6000 px。高さ 300–6000 px |
reference_video | video、任意、最大 3 個 | mp4、mov | サイズ上限 200 MB。幅 300–6000 px。高さ 300–6000 px。長さ 2–15 秒。フレームレート下限 24 fps、上限 60 fps。この役割の合計上限 15 秒 |
reference_audio | audio、任意、最大 3 個 | wav、mp3 | サイズ上限 15 MB。長さ 2–15 秒。この役割の合計上限 15 秒 |
素材が必須かどうかは、以下の組み合わせ制約にも従ってください。
組み合わせの制約
duration.mode="fixed"ではduration.secondsが必須です。fixedを明示する場合は秒数も指定してください。duration.mode="auto"を使う場合はduration.secondsを送らないでください。reference_image、reference_video、reference_audioのうち少なくとも 1 つを指定してください。- 参照音声は単独では使えません。参照画像または参照動画も指定してください。
リクエスト例
以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。
{ "model": "doubao-seedance-2-0-mini-260615", "operation": "reference_to_video", "prompt": "Create a product video of the blue ceramic mug in the reference image. Keep its shape and color.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "reference", "type": "image", "role": "reference_image", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}よくある 422 エラー
| 422 エラーコード | 対処方法 |
|---|---|
enum / range / step | この節のフィールド表に従って値と刻み幅を調整する。 |
unsupported_field | この操作のフィールド表にないフィールドを削除する。 |
requires | この節の組み合わせ制約に従って秒数、アスペクト比、音声設定、素材を補う。 |
excludes | 自動の長さや末尾フレームと競合するフィールドを削除する。 |
count / media_role | この節の素材表に従って役割と数を調整する。 |
video_input_unsupported | 公開 HTTPS URL、Content-Type、ファイル形式を確認し、再度見積もりを取得する。 |
doubao-seedance-2-5-260628
参照素材で被写体や動作の特徴を保ちたい場合に使います。
model にこの節の Model ID、operation に reference_to_video を設定します。生成フィールドは以下の表にあるものだけを使い、素材は media 配列に入れてください。
| フィールド | 型 | 必須 | 選択肢または範囲 | デフォルト |
|---|---|---|---|---|
audio.mode | string | いいえ | on、off | on |
duration.mode | string | いいえ | fixed、auto | auto |
duration.seconds | integer | いいえ | 4–30、1 秒刻み。固定長の場合のみ | なし |
output.aspect_ratio | string | いいえ | 16:9、4:3、1:1、3:4、9:16、21:9、adaptive | adaptive |
output.format | string | いいえ | mp4 | mp4 |
output.resolution | string | いいえ | 480p、720p、1080p | 720p |
prompt | string | はい | 文字列 | なし |
watermark | boolean | いいえ | false、true | false |
素材の要件
| 素材の役割 | 種類と数 | 形式 | ファイルごとの制限 |
|---|---|---|---|
reference_image | image、任意、最大 30 個 | jpeg、png、webp、bmp、tiff、gif、heic、heif | サイズ 1–31457279 バイト。幅 300–6000 px。高さ 300–6000 px |
reference_video | video、任意、最大 10 個 | mp4、mov | サイズ上限 200 MB。幅 300–6000 px。高さ 300–6000 px。長さ 2–30 秒。フレームレート下限 24 fps、上限 60 fps。この役割の合計上限 30 秒 |
reference_audio | audio、任意、最大 10 個 | wav、mp3 | サイズ上限 15 MB。長さ 2–30 秒。この役割の合計上限 30 秒 |
素材が必須かどうかは、以下の組み合わせ制約にも従ってください。
組み合わせの制約
duration.mode="fixed"ではduration.secondsが必須です。fixedを明示する場合は秒数も指定してください。duration.mode="auto"を使う場合はduration.secondsを送らないでください。reference_image、reference_video、reference_audioのうち少なくとも 1 つを指定してください。
リクエスト例
以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。
{ "model": "doubao-seedance-2-5-260628", "operation": "reference_to_video", "prompt": "Create a product video of the blue ceramic mug in the reference image. Keep its shape and color.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "reference", "type": "image", "role": "reference_image", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}よくある 422 エラー
| 422 エラーコード | 対処方法 |
|---|---|
enum / range / step | この節のフィールド表に従って値と刻み幅を調整する。 |
unsupported_field | この操作のフィールド表にないフィールドを削除する。 |
requires | この節の組み合わせ制約に従って秒数、アスペクト比、音声設定、素材を補う。 |
excludes | 自動の長さや末尾フレームと競合するフィールドを削除する。 |
count / media_role | この節の素材表に従って役割と数を調整する。 |
video_input_unsupported | 公開 HTTPS URL、Content-Type、ファイル形式を確認し、再度見積もりを取得する。 |
公式資料
BetterToken を呼び出す際は、このページのフィールドとリアルタイムのモデルカタログで該当する操作を確認してください。

