コンテンツにスキップ
無料で登録
Seedance

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-SRimage_to_video5–10、5 刻み720p、1080p、4k16:9、4:3、1:1、3:4、9:16、21:9、adaptiveon、offfirst_frame
ByteDance-Seedance-2.0-SRtext_to_video5–10、5 刻み720p、1080p、4k16:9、4:3、1:1、3:4、9:16、21:9、adaptiveon、offなし
ByteDance-Seedance-2.5-SRimage_to_video5–10、5 刻み720p、1080p16:9、4:3、1:1、3:4、9:16、21:9、adaptiveon、offfirst_frame
ByteDance-Seedance-2.5-SRtext_to_video5–10、5 刻み720p、1080p16:9、4:3、1:1、3:4、9:16、21:9、adaptiveon、offなし
doubao-seedance-2-0-260128image_to_video4–15、1 刻み。auto も使用可能480p、720p、1080p、4k16:9、4:3、1:1、3:4、9:16、21:9、adaptiveon、offfirst_frame、last_frame
doubao-seedance-2-0-260128reference_to_video4–15、1 刻み。auto も使用可能480p、720p、1080p、4k16:9、4:3、1:1、3:4、9:16、21:9、adaptiveon、offreference_image、reference_video、reference_audio
doubao-seedance-2-0-260128text_to_video4–15、1 刻み。auto も使用可能480p、720p、1080p、4k16:9、4:3、1:1、3:4、9:16、21:9、adaptiveon、offなし
doubao-seedance-2-0-fast-260128image_to_video4–15、1 刻み。auto も使用可能480p、720p16:9、4:3、1:1、3:4、9:16、21:9、adaptiveon、offfirst_frame、last_frame
doubao-seedance-2-0-fast-260128reference_to_video4–15、1 刻み。auto も使用可能480p、720p16:9、4:3、1:1、3:4、9:16、21:9、adaptiveon、offreference_image、reference_video、reference_audio
doubao-seedance-2-0-fast-260128text_to_video4–15、1 刻み。auto も使用可能480p、720p16:9、4:3、1:1、3:4、9:16、21:9、adaptiveon、offなし
doubao-seedance-2-0-mini-260615image_to_video4–15、1 刻み。auto も使用可能480p、720p16:9、4:3、1:1、3:4、9:16、21:9、adaptiveon、offfirst_frame、last_frame
doubao-seedance-2-0-mini-260615reference_to_video4–15、1 刻み。auto も使用可能480p、720p16:9、4:3、1:1、3:4、9:16、21:9、adaptiveon、offreference_image、reference_video、reference_audio
doubao-seedance-2-0-mini-260615text_to_video4–15、1 刻み。auto も使用可能480p、720p16:9、4:3、1:1、3:4、9:16、21:9、adaptiveon、offなし
doubao-seedance-2-5-260628image_to_video4–30、1 刻み。auto も使用可能480p、720p、1080padaptiveon、offfirst_frame、last_frame
doubao-seedance-2-5-260628reference_to_video4–30、1 刻み。auto も使用可能480p、720p、1080p16:9、4:3、1:1、3:4、9:16、21:9、adaptiveon、offreference_image、reference_video、reference_audio
doubao-seedance-2-5-260628text_to_video4–30、1 刻み。auto も使用可能480p、720p、1080p16:9、4:3、1:1、3:4、9:16、21:9、adaptiveon、offなし

SR の 2 モデルの固定長は 5 秒または 10 秒のみです。中国リージョンと SR のモデルは Model ID が異なります。別のモデルのフィールドや素材制限を流用しないでください。

サンプル素材

画像からの動画生成と画像参照の例には、白いテーブルの上にある青い陶器のマグカップを使います。そのまま試すか、自分に使用権があり、このページの制限を満たす公開 HTTPS 素材に置き換えてください。

動画生成の参照画像:白いテーブルの上にある青い陶器のマグカップ

テキストから動画を生成する

ByteDance-Seedance-2.0-SR

テキストの説明だけで動画を生成したい場合に使います。

model にこの節の Model ID、operation に text_to_video を設定します。生成フィールドは以下の表にあるものだけを使い、素材は media 配列に入れてください。

フィールド型必須選択肢または範囲デフォルト
audio.modestringいいえon、offon
duration.modestringいいえfixedfixed
duration.secondsintegerいいえ5–10、5 秒刻み。固定長の場合のみ5
output.aspect_ratiostringいいえ16:9、4:3、1:1、3:4、9:16、21:9、adaptive16:9
output.formatstringいいえmp4mp4
output.resolutionstringいいえ720p、1080p、4k720p
promptstringはい文字列なし
watermarkbooleanいいえfalsefalse

素材の要件

この操作は素材を受け付けません。

組み合わせの制約

  • 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.modestringいいえon、offon
duration.modestringいいえfixedfixed
duration.secondsintegerいいえ5–10、5 秒刻み。固定長の場合のみ5
output.aspect_ratiostringいいえ16:9、4:3、1:1、3:4、9:16、21:9、adaptive16:9
output.formatstringいいえmp4mp4
output.resolutionstringいいえ720p、1080p720p
promptstringはい文字列なし
watermarkbooleanいいえfalsefalse

素材の要件

この操作は素材を受け付けません。

組み合わせの制約

  • 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.modestringいいえon、offon
duration.modestringいいえfixed、autofixed
duration.secondsintegerいいえ4–15、1 秒刻み。固定長の場合のみなし
output.aspect_ratiostringいいえ16:9、4:3、1:1、3:4、9:16、21:9、adaptiveadaptive
output.formatstringいいえmp4mp4
output.resolutionstringいいえ480p、720p、1080p、4k720p
promptstringはい文字列なし
watermarkbooleanいいえfalse、truefalse

素材の要件

この操作は素材を受け付けません。

組み合わせの制約

  • 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.modestringいいえon、offon
duration.modestringいいえfixed、autofixed
duration.secondsintegerいいえ4–15、1 秒刻み。固定長の場合のみなし
output.aspect_ratiostringいいえ16:9、4:3、1:1、3:4、9:16、21:9、adaptiveadaptive
output.formatstringいいえmp4mp4
output.resolutionstringいいえ480p、720p720p
promptstringはい文字列なし
watermarkbooleanいいえfalse、truefalse

素材の要件

この操作は素材を受け付けません。

組み合わせの制約

  • 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.modestringいいえon、offon
duration.modestringいいえfixed、autofixed
duration.secondsintegerいいえ4–15、1 秒刻み。固定長の場合のみなし
output.aspect_ratiostringいいえ16:9、4:3、1:1、3:4、9:16、21:9、adaptiveadaptive
output.formatstringいいえmp4mp4
output.resolutionstringいいえ480p、720p720p
promptstringはい文字列なし
watermarkbooleanいいえfalse、truefalse

素材の要件

この操作は素材を受け付けません。

組み合わせの制約

  • 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.modestringいいえon、offon
duration.modestringいいえfixed、autoauto
duration.secondsintegerいいえ4–30、1 秒刻み。固定長の場合のみなし
output.aspect_ratiostringいいえ16:9、4:3、1:1、3:4、9:16、21:9、adaptiveadaptive
output.formatstringいいえmp4mp4
output.resolutionstringいいえ480p、720p、1080p720p
promptstringはい文字列なし
watermarkbooleanいいえfalse、truefalse

素材の要件

この操作は素材を受け付けません。

組み合わせの制約

  • 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.modestringいいえon、offon
duration.modestringいいえfixedfixed
duration.secondsintegerいいえ5–10、5 秒刻み。固定長の場合のみ5
output.aspect_ratiostringいいえ16:9、4:3、1:1、3:4、9:16、21:9、adaptive16:9
output.formatstringいいえmp4mp4
output.resolutionstringいいえ720p、1080p、4k720p
promptstringはい文字列なし
watermarkbooleanいいえfalsefalse

素材の要件

素材の役割種類と数形式ファイルごとの制限
first_frameimage、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.modestringいいえon、offon
duration.modestringいいえfixedfixed
duration.secondsintegerいいえ5–10、5 秒刻み。固定長の場合のみ5
output.aspect_ratiostringいいえ16:9、4:3、1:1、3:4、9:16、21:9、adaptive16:9
output.formatstringいいえmp4mp4
output.resolutionstringいいえ720p、1080p720p
promptstringはい文字列なし
watermarkbooleanいいえfalsefalse

素材の要件

素材の役割種類と数形式ファイルごとの制限
first_frameimage、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.modestringいいえon、offon
duration.modestringいいえfixed、autofixed
duration.secondsintegerいいえ4–15、1 秒刻み。固定長の場合のみなし
output.aspect_ratiostringいいえ16:9、4:3、1:1、3:4、9:16、21:9、adaptiveadaptive
output.formatstringいいえmp4mp4
output.resolutionstringいいえ480p、720p、1080p、4k720p
promptstringはい文字列なし
watermarkbooleanいいえfalse、truefalse

素材の要件

素材の役割種類と数形式ファイルごとの制限
first_frameimage、1 個(必須)jpeg、png、webp、bmp、tiff、gif、heic、heifサイズ 1–31457279 バイト。幅 300–6000 px。高さ 300–6000 px
last_frameimage、任意、最大 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.modestringいいえon、offon
duration.modestringいいえfixed、autofixed
duration.secondsintegerいいえ4–15、1 秒刻み。固定長の場合のみなし
output.aspect_ratiostringいいえ16:9、4:3、1:1、3:4、9:16、21:9、adaptiveadaptive
output.formatstringいいえmp4mp4
output.resolutionstringいいえ480p、720p720p
promptstringはい文字列なし
watermarkbooleanいいえfalse、truefalse

素材の要件

素材の役割種類と数形式ファイルごとの制限
first_frameimage、1 個(必須)jpeg、png、webp、bmp、tiff、gif、heic、heifサイズ 1–31457279 バイト。幅 300–6000 px。高さ 300–6000 px
last_frameimage、任意、最大 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.modestringいいえon、offon
duration.modestringいいえfixed、autofixed
duration.secondsintegerいいえ4–15、1 秒刻み。固定長の場合のみなし
output.aspect_ratiostringいいえ16:9、4:3、1:1、3:4、9:16、21:9、adaptiveadaptive
output.formatstringいいえmp4mp4
output.resolutionstringいいえ480p、720p720p
promptstringはい文字列なし
watermarkbooleanいいえfalse、truefalse

素材の要件

素材の役割種類と数形式ファイルごとの制限
first_frameimage、1 個(必須)jpeg、png、webp、bmp、tiff、gif、heic、heifサイズ 1–31457279 バイト。幅 300–6000 px。高さ 300–6000 px
last_frameimage、任意、最大 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.modestringいいえon、offon
duration.modestringいいえfixed、autoauto
duration.secondsintegerいいえ4–30、1 秒刻み。固定長の場合のみなし
output.aspect_ratiostringいいえadaptiveadaptive
output.formatstringいいえmp4mp4
output.resolutionstringいいえ480p、720p、1080p720p
promptstringはい文字列なし
watermarkbooleanいいえfalse、truefalse

素材の要件

素材の役割種類と数形式ファイルごとの制限
first_frameimage、1 個(必須)jpeg、png、webp、bmp、tiff、gif、heic、heifサイズ 1–31457279 バイト。幅 300–6000 px。高さ 300–6000 px
last_frameimage、任意、最大 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.modestringいいえon、offon
duration.modestringいいえfixed、autofixed
duration.secondsintegerいいえ4–15、1 秒刻み。固定長の場合のみなし
output.aspect_ratiostringいいえ16:9、4:3、1:1、3:4、9:16、21:9、adaptiveadaptive
output.formatstringいいえmp4mp4
output.resolutionstringいいえ480p、720p、1080p、4k720p
promptstringはい文字列なし
watermarkbooleanいいえfalse、truefalse

素材の要件

素材の役割種類と数形式ファイルごとの制限
reference_imageimage、任意、最大 9 個jpeg、png、webp、bmp、tiff、gif、heic、heifサイズ 1–31457279 バイト。幅 300–6000 px。高さ 300–6000 px
reference_videovideo、任意、最大 3 個mp4、movサイズ上限 200 MB。幅 300–6000 px。高さ 300–6000 px。長さ 2–15 秒。フレームレート下限 24 fps、上限 60 fps。この役割の合計上限 15 秒
reference_audioaudio、任意、最大 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.modestringいいえon、offon
duration.modestringいいえfixed、autofixed
duration.secondsintegerいいえ4–15、1 秒刻み。固定長の場合のみなし
output.aspect_ratiostringいいえ16:9、4:3、1:1、3:4、9:16、21:9、adaptiveadaptive
output.formatstringいいえmp4mp4
output.resolutionstringいいえ480p、720p720p
promptstringはい文字列なし
watermarkbooleanいいえfalse、truefalse

素材の要件

素材の役割種類と数形式ファイルごとの制限
reference_imageimage、任意、最大 9 個jpeg、png、webp、bmp、tiff、gif、heic、heifサイズ 1–31457279 バイト。幅 300–6000 px。高さ 300–6000 px
reference_videovideo、任意、最大 3 個mp4、movサイズ上限 200 MB。幅 300–6000 px。高さ 300–6000 px。長さ 2–15 秒。フレームレート下限 24 fps、上限 60 fps。この役割の合計上限 15 秒
reference_audioaudio、任意、最大 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.modestringいいえon、offon
duration.modestringいいえfixed、autofixed
duration.secondsintegerいいえ4–15、1 秒刻み。固定長の場合のみなし
output.aspect_ratiostringいいえ16:9、4:3、1:1、3:4、9:16、21:9、adaptiveadaptive
output.formatstringいいえmp4mp4
output.resolutionstringいいえ480p、720p720p
promptstringはい文字列なし
watermarkbooleanいいえfalse、truefalse

素材の要件

素材の役割種類と数形式ファイルごとの制限
reference_imageimage、任意、最大 9 個jpeg、png、webp、bmp、tiff、gif、heic、heifサイズ 1–31457279 バイト。幅 300–6000 px。高さ 300–6000 px
reference_videovideo、任意、最大 3 個mp4、movサイズ上限 200 MB。幅 300–6000 px。高さ 300–6000 px。長さ 2–15 秒。フレームレート下限 24 fps、上限 60 fps。この役割の合計上限 15 秒
reference_audioaudio、任意、最大 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.modestringいいえon、offon
duration.modestringいいえfixed、autoauto
duration.secondsintegerいいえ4–30、1 秒刻み。固定長の場合のみなし
output.aspect_ratiostringいいえ16:9、4:3、1:1、3:4、9:16、21:9、adaptiveadaptive
output.formatstringいいえmp4mp4
output.resolutionstringいいえ480p、720p、1080p720p
promptstringはい文字列なし
watermarkbooleanいいえfalse、truefalse

素材の要件

素材の役割種類と数形式ファイルごとの制限
reference_imageimage、任意、最大 30 個jpeg、png、webp、bmp、tiff、gif、heic、heifサイズ 1–31457279 バイト。幅 300–6000 px。高さ 300–6000 px
reference_videovideo、任意、最大 10 個mp4、movサイズ上限 200 MB。幅 300–6000 px。高さ 300–6000 px。長さ 2–30 秒。フレームレート下限 24 fps、上限 60 fps。この役割の合計上限 30 秒
reference_audioaudio、任意、最大 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 を呼び出す際は、このページのフィールドとリアルタイムのモデルカタログで該当する操作を確認してください。