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-i2v | image_to_video | 2–15、1 刻み | 720p、1080p | 指定しない | provider_default | first_frame、last_frame、driving_audio |
wan2.7-r2v | reference_to_video | 2–15、1 刻み | 720p、1080p | 16:9、9:16、1:1、4:3、3:4 | provider_default | reference_image、reference_video |
wan2.7-t2v | text_to_video | 2–15、1 刻み | 720p、1080p | 16:9、9:16、1:1、4:3、3:4 | provider_default | driving_audio |
wan2.7-videoedit | video_edit | 2–15、1 刻み。auto も使用可能 | 720p、1080p | 指定しない | provider_default | base_video |
wan3.0-video-prime | image_to_video | 2–30、1 刻み。auto も使用可能 | 480p、720p、1080p | adaptive、21:9、16:9、4:3、1:1、3:4、9:16 | on、off | first_frame、last_frame |
wan3.0-video-prime | reference_to_video | 2–30、1 刻み。auto も使用可能 | 480p、720p、1080p | adaptive、21:9、16:9、4:3、1:1、3:4、9:16 | on、off | reference_image、reference_video、reference_audio |
wan3.0-video-prime | text_to_video | 2–30、1 刻み。auto も使用可能 | 480p、720p、1080p | adaptive、21:9、16:9、4:3、1:1、3:4、9:16 | on、off | なし |
wan3.0-video | image_to_video | 2–30、1 刻み。auto も使用可能 | 480p、720p、1080p | adaptive、21:9、16:9、4:3、1:1、3:4、9:16 | on、off | first_frame、last_frame |
wan3.0-video | reference_to_video | 2–30、1 刻み。auto も使用可能 | 480p、720p、1080p | adaptive、21:9、16:9、4:3、1:1、3:4、9:16 | on、off | reference_image、reference_video、reference_audio |
wan3.0-video | text_to_video | 2–30、1 刻み。auto も使用可能 | 480p、720p、1080p | adaptive、21:9、16:9、4:3、1:1、3:4、9:16 | on、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.mode | string | いいえ | provider_default | provider_default |
duration.mode | string | いいえ | fixed | fixed |
duration.seconds | integer | いいえ | 2–15、1 秒刻み。固定長の場合のみ | 5 |
output.aspect_ratio | string | いいえ | 16:9、9:16、1:1、4:3、3:4 | 16:9 |
output.format | string | いいえ | mp4 | mp4 |
output.resolution | string | いいえ | 720p、1080p | 1080p |
prompt | string | はい | 文字列 | なし |
provider_options.alibaba.prompt_extend | boolean | いいえ | true / false。プロンプトの拡張を制御 | true |
seed | integer | いいえ | 0–2147483647、1 刻み。乱数シード。0 も使用可能 | なし |
watermark | boolean | いいえ | false、true | false |
素材の要件
| 素材の役割 | 種類と数 | 形式 | ファイルごとの制限 |
|---|---|---|---|
driving_audio | audio、任意、最大 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.mode | string | いいえ | on、off | on |
duration.mode | string | いいえ | fixed、auto | fixed |
duration.seconds | integer | いいえ | 2–30、1 秒刻み。固定長の場合のみ | 5 |
output.aspect_ratio | string | いいえ | adaptive、21:9、16:9、4:3、1:1、3:4、9:16 | adaptive |
output.format | string | いいえ | mp4 | mp4 |
output.resolution | string | いいえ | 480p、720p、1080p | 1080p |
prompt | string | はい | 文字列 | なし |
provider_options.alibaba.prompt_extend | boolean | いいえ | true / false。プロンプトの拡張を制御 | true |
seed | integer | いいえ | 0–2147483647、1 刻み。乱数シード。0 も使用可能 | なし |
watermark | boolean | いいえ | false、true | false |
素材の要件
この操作は素材を受け付けません。
組み合わせの制約
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.mode | string | いいえ | on、off | on |
duration.mode | string | いいえ | fixed、auto | fixed |
duration.seconds | integer | いいえ | 2–30、1 秒刻み。固定長の場合のみ | 5 |
output.aspect_ratio | string | いいえ | adaptive、21:9、16:9、4:3、1:1、3:4、9:16 | adaptive |
output.format | string | いいえ | mp4 | mp4 |
output.resolution | string | いいえ | 480p、720p、1080p | 1080p |
prompt | string | はい | 文字列 | なし |
provider_options.alibaba.prompt_extend | boolean | いいえ | true / false。プロンプトの拡張を制御 | true |
seed | integer | いいえ | 0–2147483647、1 刻み。乱数シード。0 も使用可能 | なし |
watermark | boolean | いいえ | false、true | false |
素材の要件
この操作は素材を受け付けません。
組み合わせの制約
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.mode | string | いいえ | provider_default | provider_default |
duration.mode | string | いいえ | fixed | fixed |
duration.seconds | integer | いいえ | 2–15、1 秒刻み。固定長の場合のみ | 5 |
output.format | string | いいえ | mp4 | mp4 |
output.resolution | string | いいえ | 720p、1080p | 1080p |
prompt | string | はい | 文字列 | なし |
provider_options.alibaba.prompt_extend | boolean | いいえ | true / false。プロンプトの拡張を制御 | true |
seed | integer | いいえ | 0–2147483647、1 刻み。乱数シード。0 も使用可能 | なし |
watermark | boolean | いいえ | false、true | false |
素材の要件
| 素材の役割 | 種類と数 | 形式 | ファイルごとの制限 |
|---|---|---|---|
first_frame | image、1 個(必須) | jpeg、jpg、png、bmp、webp | サイズ上限 20 MB。幅 240–8000 px。高さ 240–8000 px |
last_frame | image、任意、最大 1 個 | jpeg、jpg、png、bmp、webp | サイズ上限 20 MB。幅 240–8000 px。高さ 240–8000 px |
driving_audio | audio、任意、最大 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.mode | string | いいえ | on、off | on |
duration.mode | string | いいえ | fixed、auto | fixed |
duration.seconds | integer | いいえ | 2–30、1 秒刻み。固定長の場合のみ | 5 |
output.aspect_ratio | string | いいえ | adaptive、21:9、16:9、4:3、1:1、3:4、9:16 | adaptive |
output.format | string | いいえ | mp4 | mp4 |
output.resolution | string | いいえ | 480p、720p、1080p | 1080p |
prompt | string | はい | 文字列 | なし |
provider_options.alibaba.prompt_extend | boolean | いいえ | true / false。プロンプトの拡張を制御 | true |
seed | integer | いいえ | 0–2147483647、1 刻み。乱数シード。0 も使用可能 | なし |
watermark | boolean | いいえ | false、true | false |
素材の要件
| 素材の役割 | 種類と数 | 形式 | ファイルごとの制限 |
|---|---|---|---|
first_frame | image、1 個(必須) | jpeg、jpg、png、bmp、webp | サイズ上限 20 MB。幅 240–8000 px。高さ 240–8000 px |
last_frame | image、任意、最大 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.mode | string | いいえ | on、off | on |
duration.mode | string | いいえ | fixed、auto | fixed |
duration.seconds | integer | いいえ | 2–30、1 秒刻み。固定長の場合のみ | 5 |
output.aspect_ratio | string | いいえ | adaptive、21:9、16:9、4:3、1:1、3:4、9:16 | adaptive |
output.format | string | いいえ | mp4 | mp4 |
output.resolution | string | いいえ | 480p、720p、1080p | 1080p |
prompt | string | はい | 文字列 | なし |
provider_options.alibaba.prompt_extend | boolean | いいえ | true / false。プロンプトの拡張を制御 | true |
seed | integer | いいえ | 0–2147483647、1 刻み。乱数シード。0 も使用可能 | なし |
watermark | boolean | いいえ | false、true | false |
素材の要件
| 素材の役割 | 種類と数 | 形式 | ファイルごとの制限 |
|---|---|---|---|
first_frame | image、1 個(必須) | jpeg、jpg、png、bmp、webp | サイズ上限 20 MB。幅 240–8000 px。高さ 240–8000 px |
last_frame | image、任意、最大 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.mode | string | いいえ | provider_default | provider_default |
duration.mode | string | いいえ | fixed | fixed |
duration.seconds | integer | いいえ | 2–15、1 秒刻み。固定長の場合のみ | 5 |
output.aspect_ratio | string | いいえ | 16:9、9:16、1:1、4:3、3:4 | 16:9 |
output.format | string | いいえ | mp4 | mp4 |
output.resolution | string | いいえ | 720p、1080p | 1080p |
prompt | string | はい | 文字列 | なし |
provider_options.alibaba.prompt_extend | boolean | いいえ | true / false。プロンプトの拡張を制御 | true |
seed | integer | いいえ | 0–2147483647、1 刻み。乱数シード。0 も使用可能 | なし |
watermark | boolean | いいえ | false、true | false |
素材の要件
| 素材の役割 | 種類と数 | 形式 | ファイルごとの制限 |
|---|---|---|---|
reference_image | image、任意、最大 10 個 | jpeg、jpg、png、bmp、webp | サイズ上限 20 MB。幅 240–8000 px。高さ 240–8000 px |
reference_video | video、任意、最大 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.mode | string | いいえ | on、off | on |
duration.mode | string | いいえ | fixed、auto | fixed |
duration.seconds | integer | いいえ | 2–30、1 秒刻み。固定長の場合のみ | 5 |
output.aspect_ratio | string | いいえ | adaptive、21:9、16:9、4:3、1:1、3:4、9:16 | adaptive |
output.format | string | いいえ | mp4 | mp4 |
output.resolution | string | いいえ | 480p、720p、1080p | 1080p |
prompt | string | はい | 文字列 | なし |
provider_options.alibaba.prompt_extend | boolean | いいえ | true / false。プロンプトの拡張を制御 | true |
seed | integer | いいえ | 0–2147483647、1 刻み。乱数シード。0 も使用可能 | なし |
watermark | boolean | いいえ | false、true | false |
素材の要件
| 素材の役割 | 種類と数 | 形式 | ファイルごとの制限 |
|---|---|---|---|
reference_image | image、任意、最大 10 個 | jpeg、jpg、png、bmp、webp | サイズ上限 20 MB。幅 240–8000 px。高さ 240–8000 px |
reference_video | video、任意、最大 5 個 | mp4、mov | サイズ上限 100 MB。幅 240–4096 px。高さ 240–4096 px。長さ 1–15 秒。フレームレート下限 16 fps。この役割の合計上限 15 秒 |
reference_audio | audio、任意、最大 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.mode | string | いいえ | on、off | on |
duration.mode | string | いいえ | fixed、auto | fixed |
duration.seconds | integer | いいえ | 2–30、1 秒刻み。固定長の場合のみ | 5 |
output.aspect_ratio | string | いいえ | adaptive、21:9、16:9、4:3、1:1、3:4、9:16 | adaptive |
output.format | string | いいえ | mp4 | mp4 |
output.resolution | string | いいえ | 480p、720p、1080p | 1080p |
prompt | string | はい | 文字列 | なし |
provider_options.alibaba.prompt_extend | boolean | いいえ | true / false。プロンプトの拡張を制御 | true |
seed | integer | いいえ | 0–2147483647、1 刻み。乱数シード。0 も使用可能 | なし |
watermark | boolean | いいえ | false、true | false |
素材の要件
| 素材の役割 | 種類と数 | 形式 | ファイルごとの制限 |
|---|---|---|---|
reference_image | image、任意、最大 10 個 | jpeg、jpg、png、bmp、webp | サイズ上限 20 MB。幅 240–8000 px。高さ 240–8000 px |
reference_video | video、任意、最大 5 個 | mp4、mov | サイズ上限 100 MB。幅 240–4096 px。高さ 240–4096 px。長さ 1–15 秒。フレームレート下限 16 fps。この役割の合計上限 15 秒 |
reference_audio | audio、任意、最大 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.mode | string | いいえ | provider_default | provider_default |
duration.mode | string | いいえ | fixed、auto | auto |
duration.seconds | integer | いいえ | 2–15、1 秒刻み。固定長の場合のみ | なし |
output.format | string | いいえ | mp4 | mp4 |
output.resolution | string | いいえ | 720p、1080p | 1080p |
prompt | string | はい | 文字列 | なし |
provider_options.alibaba.prompt_extend | boolean | いいえ | true / false。プロンプトの拡張を制御 | true |
seed | integer | いいえ | 0–2147483647、1 刻み。乱数シード。0 も使用可能 | なし |
watermark | boolean | いいえ | false、true | false |
素材の要件
| 素材の役割 | 種類と数 | 形式 | ファイルごとの制限 |
|---|---|---|---|
base_video | video、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 を呼び出す際は、このページのフィールドとリアルタイムのモデルカタログで該当する操作を確認してください。

