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

Wan 動画 API:テキスト・画像・参照からの生成と編集

BetterToken API Key で Wan に接続し、Model ID と操作に応じたフィールド、素材、生成方法を選びます。

テキスト、先頭フレーム、参照素材から動画を生成し、既存の動画を編集できます。3.0 と Prime は 3 種類の生成操作に対応します。2.7 はテキストからの動画生成、画像からの動画生成、参照生成、編集それぞれに対応する 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操作長さ(秒)出力設定アスペクト比音声素材の役割
wan2.7-i2vimage_to_video2–15、1 刻み720p、1080p指定しないprovider_defaultfirst_frame、last_frame、driving_audio
wan2.7-r2vreference_to_video2–15、1 刻み720p、1080p16:9、9:16、1:1、4:3、3:4provider_defaultreference_image、reference_video
wan2.7-t2vtext_to_video2–15、1 刻み720p、1080p16:9、9:16、1:1、4:3、3:4provider_defaultdriving_audio
wan2.7-videoeditvideo_edit2–15、1 刻み。auto も使用可能720p、1080p指定しないprovider_defaultbase_video
wan3.0-video-primeimage_to_video2–30、1 刻み。auto も使用可能480p、720p、1080padaptive、21:9、16:9、4:3、1:1、3:4、9:16on、offfirst_frame、last_frame
wan3.0-video-primereference_to_video2–30、1 刻み。auto も使用可能480p、720p、1080padaptive、21:9、16:9、4:3、1:1、3:4、9:16on、offreference_image、reference_video、reference_audio
wan3.0-video-primetext_to_video2–30、1 刻み。auto も使用可能480p、720p、1080padaptive、21:9、16:9、4:3、1:1、3:4、9:16on、offなし
wan3.0-videoimage_to_video2–30、1 刻み。auto も使用可能480p、720p、1080padaptive、21:9、16:9、4:3、1:1、3:4、9:16on、offfirst_frame、last_frame
wan3.0-videoreference_to_video2–30、1 刻み。auto も使用可能480p、720p、1080padaptive、21:9、16:9、4:3、1:1、3:4、9:16on、offreference_image、reference_video、reference_audio
wan3.0-videotext_to_video2–30、1 刻み。auto も使用可能480p、720p、1080padaptive、21:9、16:9、4:3、1:1、3:4、9:16on、offなし

画像から動画(wan2.7-i2v、および adaptive 指定時の wan3.0-video / wan3.0-video-prime)と、adaptive 指定の参照から動画では、出力のアスペクト比は入力画像に従います。出力ティアは固定の縦横サイズではなく総画素数を決めます。このページの 1:1 サンプル画像では、当社の検証で 720p が 960×960、480p が 640×640 になりました。横長・縦長を固定したい場合は output.aspect_ratio を明示してください(wan2.7-i2v はこのフィールドに対応していないため、目的の比率の入力画像を使ってください)。

サンプル素材

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

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

編集例には街の広場にいる少年の動画を使います。約 5.04 秒、1280 × 720、24 fps です。参照画像ではなく base_video として送ります。

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

wan2.7-t2v

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

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

フィールド型必須選択肢または範囲デフォルト
audio.modestringいいえprovider_defaultprovider_default
duration.modestringいいえfixedfixed
duration.secondsintegerいいえ2–15、1 秒刻み。固定長の場合のみ5
output.aspect_ratiostringいいえ16:9、9:16、1:1、4:3、3:416:9
output.formatstringいいえmp4mp4
output.resolutionstringいいえ720p、1080p1080p
promptstringはい文字列なし
provider_options.alibaba.prompt_extendbooleanいいえtrue / false。プロンプトの拡張を制御true
seedintegerいいえ0–2147483647、1 刻み。乱数シード。0 も使用可能なし
watermarkbooleanいいえfalse、truefalse

素材の要件

素材の役割種類と数形式ファイルごとの制限
driving_audioaudio、任意、最大 1 個wav、mp3サイズ上限 15 MB。長さ 2–30 秒

素材が必須かどうかは、以下の組み合わせ制約にも従ってください。

任意の driving_audio は駆動音声で、type="audio" を使います。参照生成の reference_audio とは別の素材の役割です。

組み合わせの制約

  • duration.mode="fixed" では duration.seconds が必須です。fixed を明示する場合は秒数も指定してください。

リクエスト例

以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。

{
"model": "wan2.7-t2v",
"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この節の組み合わせ制約に従って秒数、アスペクト比、音声設定、素材を補う。
count / media_roleこの節の素材表に従って役割と数を調整する。
video_input_unsupported公開 HTTPS URL、Content-Type、ファイル形式を確認し、再度見積もりを取得する。

wan3.0-video-prime

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

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

フィールド型必須選択肢または範囲デフォルト
audio.modestringいいえon、offon
duration.modestringいいえfixed、autofixed
duration.secondsintegerいいえ2–30、1 秒刻み。固定長の場合のみ5
output.aspect_ratiostringいいえadaptive、21:9、16:9、4:3、1:1、3:4、9:16adaptive
output.formatstringいいえmp4mp4
output.resolutionstringいいえ480p、720p、1080p1080p
promptstringはい文字列なし
provider_options.alibaba.prompt_extendbooleanいいえtrue / false。プロンプトの拡張を制御true
seedintegerいいえ0–2147483647、1 刻み。乱数シード。0 も使用可能なし
watermarkbooleanいいえfalse、truefalse

素材の要件

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

組み合わせの制約

  • duration.mode="fixed" では duration.seconds が必須です。fixed を明示する場合は秒数も指定してください。
  • duration.mode="auto" を使う場合は duration.seconds を送らないでください。

リクエスト例

以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。

{
"model": "wan3.0-video-prime",
"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自動の長さや末尾フレームと競合するフィールドを削除する。

wan3.0-video

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

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

フィールド型必須選択肢または範囲デフォルト
audio.modestringいいえon、offon
duration.modestringいいえfixed、autofixed
duration.secondsintegerいいえ2–30、1 秒刻み。固定長の場合のみ5
output.aspect_ratiostringいいえadaptive、21:9、16:9、4:3、1:1、3:4、9:16adaptive
output.formatstringいいえmp4mp4
output.resolutionstringいいえ480p、720p、1080p1080p
promptstringはい文字列なし
provider_options.alibaba.prompt_extendbooleanいいえtrue / false。プロンプトの拡張を制御true
seedintegerいいえ0–2147483647、1 刻み。乱数シード。0 も使用可能なし
watermarkbooleanいいえfalse、truefalse

素材の要件

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

組み合わせの制約

  • duration.mode="fixed" では duration.seconds が必須です。fixed を明示する場合は秒数も指定してください。
  • duration.mode="auto" を使う場合は duration.seconds を送らないでください。

リクエスト例

以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。

{
"model": "wan3.0-video",
"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自動の長さや末尾フレームと競合するフィールドを削除する。

画像から動画を生成する

wan2.7-i2v

画像で開始画面、または開始・終了画面を指定したい場合に使います。

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

フィールド型必須選択肢または範囲デフォルト
audio.modestringいいえprovider_defaultprovider_default
duration.modestringいいえfixedfixed
duration.secondsintegerいいえ2–15、1 秒刻み。固定長の場合のみ5
output.formatstringいいえmp4mp4
output.resolutionstringいいえ720p、1080p1080p
promptstringはい文字列なし
provider_options.alibaba.prompt_extendbooleanいいえtrue / false。プロンプトの拡張を制御true
seedintegerいいえ0–2147483647、1 刻み。乱数シード。0 も使用可能なし
watermarkbooleanいいえfalse、truefalse

素材の要件

素材の役割種類と数形式ファイルごとの制限
first_frameimage、1 個(必須)jpeg、jpg、png、bmp、webpサイズ上限 20 MB。幅 240–8000 px。高さ 240–8000 px
last_frameimage、任意、最大 1 個jpeg、jpg、png、bmp、webpサイズ上限 20 MB。幅 240–8000 px。高さ 240–8000 px
driving_audioaudio、任意、最大 1 個wav、mp3サイズ上限 15 MB。長さ 2–30 秒

素材が必須かどうかは、以下の組み合わせ制約にも従ってください。

任意の driving_audio は駆動音声で、type="audio" を使います。参照生成の reference_audio とは別の素材の役割です。

組み合わせの制約

  • duration.mode="fixed" では duration.seconds が必須です。fixed を明示する場合は秒数も指定してください。
  • first_frame は必須です。

リクエスト例

以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。

{
"model": "wan2.7-i2v",
"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"
},
"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、ファイル形式を確認し、再度見積もりを取得する。

wan3.0-video-prime

画像で開始画面、または開始・終了画面を指定したい場合に使います。

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

フィールド型必須選択肢または範囲デフォルト
audio.modestringいいえon、offon
duration.modestringいいえfixed、autofixed
duration.secondsintegerいいえ2–30、1 秒刻み。固定長の場合のみ5
output.aspect_ratiostringいいえadaptive、21:9、16:9、4:3、1:1、3:4、9:16adaptive
output.formatstringいいえmp4mp4
output.resolutionstringいいえ480p、720p、1080p1080p
promptstringはい文字列なし
provider_options.alibaba.prompt_extendbooleanいいえtrue / false。プロンプトの拡張を制御true
seedintegerいいえ0–2147483647、1 刻み。乱数シード。0 も使用可能なし
watermarkbooleanいいえfalse、truefalse

素材の要件

素材の役割種類と数形式ファイルごとの制限
first_frameimage、1 個(必須)jpeg、jpg、png、bmp、webpサイズ上限 20 MB。幅 240–8000 px。高さ 240–8000 px
last_frameimage、任意、最大 1 個jpeg、jpg、png、bmp、webpサイズ上限 20 MB。幅 240–8000 px。高さ 240–8000 px

素材が必須かどうかは、以下の組み合わせ制約にも従ってください。

組み合わせの制約

  • duration.mode="fixed" では duration.seconds が必須です。fixed を明示する場合は秒数も指定してください。
  • duration.mode="auto" を使う場合は duration.seconds を送らないでください。
  • first_frame、last_frame のうち少なくとも 1 つを指定してください。

リクエスト例

以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。

{
"model": "wan3.0-video-prime",
"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、ファイル形式を確認し、再度見積もりを取得する。

wan3.0-video

画像で開始画面、または開始・終了画面を指定したい場合に使います。

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

フィールド型必須選択肢または範囲デフォルト
audio.modestringいいえon、offon
duration.modestringいいえfixed、autofixed
duration.secondsintegerいいえ2–30、1 秒刻み。固定長の場合のみ5
output.aspect_ratiostringいいえadaptive、21:9、16:9、4:3、1:1、3:4、9:16adaptive
output.formatstringいいえmp4mp4
output.resolutionstringいいえ480p、720p、1080p1080p
promptstringはい文字列なし
provider_options.alibaba.prompt_extendbooleanいいえtrue / false。プロンプトの拡張を制御true
seedintegerいいえ0–2147483647、1 刻み。乱数シード。0 も使用可能なし
watermarkbooleanいいえfalse、truefalse

素材の要件

素材の役割種類と数形式ファイルごとの制限
first_frameimage、1 個(必須)jpeg、jpg、png、bmp、webpサイズ上限 20 MB。幅 240–8000 px。高さ 240–8000 px
last_frameimage、任意、最大 1 個jpeg、jpg、png、bmp、webpサイズ上限 20 MB。幅 240–8000 px。高さ 240–8000 px

素材が必須かどうかは、以下の組み合わせ制約にも従ってください。

組み合わせの制約

  • duration.mode="fixed" では duration.seconds が必須です。fixed を明示する場合は秒数も指定してください。
  • duration.mode="auto" を使う場合は duration.seconds を送らないでください。
  • first_frame、last_frame のうち少なくとも 1 つを指定してください。

リクエスト例

以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。

{
"model": "wan3.0-video",
"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、ファイル形式を確認し、再度見積もりを取得する。

参照素材から生成する

wan2.7-r2v

参照素材で被写体や動作の特徴を保ちたい場合に使います。

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

フィールド型必須選択肢または範囲デフォルト
audio.modestringいいえprovider_defaultprovider_default
duration.modestringいいえfixedfixed
duration.secondsintegerいいえ2–15、1 秒刻み。固定長の場合のみ5
output.aspect_ratiostringいいえ16:9、9:16、1:1、4:3、3:416:9
output.formatstringいいえmp4mp4
output.resolutionstringいいえ720p、1080p1080p
promptstringはい文字列なし
provider_options.alibaba.prompt_extendbooleanいいえtrue / false。プロンプトの拡張を制御true
seedintegerいいえ0–2147483647、1 刻み。乱数シード。0 も使用可能なし
watermarkbooleanいいえfalse、truefalse

素材の要件

素材の役割種類と数形式ファイルごとの制限
reference_imageimage、任意、最大 10 個jpeg、jpg、png、bmp、webpサイズ上限 20 MB。幅 240–8000 px。高さ 240–8000 px
reference_videovideo、任意、最大 5 個mp4、movサイズ上限 100 MB。幅 240–4096 px。高さ 240–4096 px。長さ 1–15 秒。フレームレート下限 16 fps。この役割の合計上限 15 秒

素材が必須かどうかは、以下の組み合わせ制約にも従ってください。

組み合わせの制約

  • duration.mode="fixed" では duration.seconds が必須です。fixed を明示する場合は秒数も指定してください。
  • reference_image、reference_video のうち少なくとも 1 つを指定してください。

リクエスト例

以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。

{
"model": "wan2.7-r2v",
"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": "16:9"
},
"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この節の組み合わせ制約に従って秒数、アスペクト比、音声設定、素材を補う。
count / media_roleこの節の素材表に従って役割と数を調整する。
video_input_unsupported公開 HTTPS URL、Content-Type、ファイル形式を確認し、再度見積もりを取得する。

wan3.0-video-prime

参照素材で被写体や動作の特徴を保ちたい場合に使います。

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

フィールド型必須選択肢または範囲デフォルト
audio.modestringいいえon、offon
duration.modestringいいえfixed、autofixed
duration.secondsintegerいいえ2–30、1 秒刻み。固定長の場合のみ5
output.aspect_ratiostringいいえadaptive、21:9、16:9、4:3、1:1、3:4、9:16adaptive
output.formatstringいいえmp4mp4
output.resolutionstringいいえ480p、720p、1080p1080p
promptstringはい文字列なし
provider_options.alibaba.prompt_extendbooleanいいえtrue / false。プロンプトの拡張を制御true
seedintegerいいえ0–2147483647、1 刻み。乱数シード。0 も使用可能なし
watermarkbooleanいいえfalse、truefalse

素材の要件

素材の役割種類と数形式ファイルごとの制限
reference_imageimage、任意、最大 10 個jpeg、jpg、png、bmp、webpサイズ上限 20 MB。幅 240–8000 px。高さ 240–8000 px
reference_videovideo、任意、最大 5 個mp4、movサイズ上限 100 MB。幅 240–4096 px。高さ 240–4096 px。長さ 1–15 秒。フレームレート下限 16 fps。この役割の合計上限 15 秒
reference_audioaudio、任意、最大 5 個wav、mp3サイズ上限 15 MB。長さ 1–15 秒。この役割の合計上限 15 秒

素材が必須かどうかは、以下の組み合わせ制約にも従ってください。

組み合わせの制約

  • duration.mode="fixed" では duration.seconds が必須です。fixed を明示する場合は秒数も指定してください。
  • duration.mode="auto" を使う場合は duration.seconds を送らないでください。
  • reference_image、reference_video、reference_audio のうち少なくとも 1 つを指定してください。
  • 参照動画を使う場合、入力動画の合計時間と出力時間の合計は 30 秒以内にしてください。自動の長さを使う場合も、出力の上限はこの残り時間に制限されます。

リクエスト例

以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。

{
"model": "wan3.0-video-prime",
"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自動の長さや末尾フレームと競合するフィールドを削除する。
sum_lte参照動画の合計時間または出力時間を短くして、合計を 30 秒以内にする。
count / media_roleこの節の素材表に従って役割と数を調整する。
video_input_unsupported公開 HTTPS URL、Content-Type、ファイル形式を確認し、再度見積もりを取得する。

wan3.0-video

参照素材で被写体や動作の特徴を保ちたい場合に使います。

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

フィールド型必須選択肢または範囲デフォルト
audio.modestringいいえon、offon
duration.modestringいいえfixed、autofixed
duration.secondsintegerいいえ2–30、1 秒刻み。固定長の場合のみ5
output.aspect_ratiostringいいえadaptive、21:9、16:9、4:3、1:1、3:4、9:16adaptive
output.formatstringいいえmp4mp4
output.resolutionstringいいえ480p、720p、1080p1080p
promptstringはい文字列なし
provider_options.alibaba.prompt_extendbooleanいいえtrue / false。プロンプトの拡張を制御true
seedintegerいいえ0–2147483647、1 刻み。乱数シード。0 も使用可能なし
watermarkbooleanいいえfalse、truefalse

素材の要件

素材の役割種類と数形式ファイルごとの制限
reference_imageimage、任意、最大 10 個jpeg、jpg、png、bmp、webpサイズ上限 20 MB。幅 240–8000 px。高さ 240–8000 px
reference_videovideo、任意、最大 5 個mp4、movサイズ上限 100 MB。幅 240–4096 px。高さ 240–4096 px。長さ 1–15 秒。フレームレート下限 16 fps。この役割の合計上限 15 秒
reference_audioaudio、任意、最大 5 個wav、mp3サイズ上限 15 MB。長さ 1–15 秒。この役割の合計上限 15 秒

素材が必須かどうかは、以下の組み合わせ制約にも従ってください。

組み合わせの制約

  • duration.mode="fixed" では duration.seconds が必須です。fixed を明示する場合は秒数も指定してください。
  • duration.mode="auto" を使う場合は duration.seconds を送らないでください。
  • reference_image、reference_video、reference_audio のうち少なくとも 1 つを指定してください。
  • 参照動画を使う場合、入力動画の合計時間と出力時間の合計は 30 秒以内にしてください。自動の長さを使う場合も、出力の上限はこの残り時間に制限されます。

リクエスト例

以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。

{
"model": "wan3.0-video",
"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自動の長さや末尾フレームと競合するフィールドを削除する。
sum_lte参照動画の合計時間または出力時間を短くして、合計を 30 秒以内にする。
count / media_roleこの節の素材表に従って役割と数を調整する。
video_input_unsupported公開 HTTPS URL、Content-Type、ファイル形式を確認し、再度見積もりを取得する。

動画を編集する

wan2.7-videoedit

既存の動画の映像を変更したい場合に使います。まず制限に合う元動画を用意してください。

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

フィールド型必須選択肢または範囲デフォルト
audio.modestringいいえprovider_defaultprovider_default
duration.modestringいいえfixed、autoauto
duration.secondsintegerいいえ2–15、1 秒刻み。固定長の場合のみなし
output.formatstringいいえmp4mp4
output.resolutionstringいいえ720p、1080p1080p
promptstringはい文字列なし
provider_options.alibaba.prompt_extendbooleanいいえtrue / false。プロンプトの拡張を制御true
seedintegerいいえ0–2147483647、1 刻み。乱数シード。0 も使用可能なし
watermarkbooleanいいえfalse、truefalse

素材の要件

素材の役割種類と数形式ファイルごとの制限
base_videovideo、1 個(必須)mp4、movサイズ上限 100 MB。幅 240–4096 px。高さ 240–4096 px。長さ 1–15 秒。フレームレート下限 16 fps。この役割の合計上限 15 秒

素材が必須かどうかは、以下の組み合わせ制約にも従ってください。

組み合わせの制約

  • duration.mode="fixed" では duration.seconds が必須です。fixed を明示する場合は秒数も指定してください。
  • base_video は必須です。
  • duration.mode="auto" を使う場合は duration.seconds を送らないでください。

リクエスト例

以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。

{
"model": "wan2.7-videoedit",
"operation": "video_edit",
"prompt": "Keep the boy and his motion in the source video. Give the city plaza warmer evening lighting.",
"duration": {
"mode": "auto"
},
"output": {
"resolution": "720p"
},
"media": [
{
"id": "base",
"type": "video",
"role": "base_video",
"source": "https://bettertoken.ai/video-api/shared/kling-hero-3.0.mp4"
}
]
}

よくある 422 エラー

422 エラーコード対処方法
enum / range / stepこの節のフィールド表に従って値と刻み幅を調整する。
unsupported_fieldこの操作のフィールド表にないフィールドを削除する。
requiresこの節の組み合わせ制約に従って秒数、アスペクト比、音声設定、素材を補う。
excludes自動の長さや末尾フレームと競合するフィールドを削除する。
count / media_roleこの節の素材表に従って役割と数を調整する。
video_input_unsupported公開 HTTPS URL、Content-Type、ファイル形式を確認し、再度見積もりを取得する。

公式資料

BetterToken を呼び出す際は、このページのフィールドとリアルタイムのモデルカタログで該当する操作を確認してください。