Wan3.0
Wan3.0 動画生成
- アリババクラウド万相 3.0 オールインワン参照動画モデル(統一エンドポイント)
- テキストから動画 / 先頭フレーム / 先頭・最終フレーム / マルチモーダル参照 / ファイル・Web 参照
- 解像度 480P / 720P / 1080P、長さ 2–30 秒
- 画像、動画、音声、ドキュメント、公開 Web ページを参照として利用可能
POST
認証
string
必須
生成モード
モデル名はwan3.0-video で固定。リクエストフィールドによってモードが決まります:
リクエストパラメータ
基本
string
必須
固定値:
wan3.0-videostring
テキスト説明。メディアフィールドと少なくともどちらか一方が必須。
- 最大 20,000 文字。超過分はエラーなく自動切り捨て
- 参照モードでは「图N / 视频N / 音频N」で素材を指定。番号は各メディア種別内の順序に従う
string
デフォルト:"1080P"
出力解像度(大文字小文字を区別しない)
480P720P1080P(デフォルト、最上位価格)
string
デフォルト:"adaptive"
アスペクト比。
aspect_ratio も受け付けます。adaptive(デフォルト)16:9/4:3/1:1/3:4/9:16
integer
デフォルト:"5"
生成秒数、2–30、デフォルト
5参照動画入力がある場合、入力動画の合計尺 + 出力
duration は 30 秒以下である必要があります。boolean
デフォルト:"true"
出力に音声トラックを含めるか。デフォルト
true。音声の有無で価格は変わりません。integer
乱数シード、範囲
[0, 2147483647]boolean
デフォルト:"false"
透かしを付けるか。デフォルト
falsestring
素の
image_urls の帰属先:frame— 先頭・最終フレーム族reference— 参照族
メディア入力
string[]
画像 URL 配列。ロール割当は相互排他ルールに従います。公開 URL または Base64(
data:image/png;base64,...)。object[]
ロール付き画像配列。各項目:
url:画像アドレスrole:first_frame/last_frame/reference_image(一般的な別名も可)
string[]
参照動画、最大 5 本。各 1–15 秒、合計 ≤ 15 秒
string[]
参照音声、最大 5 本。各 1–15 秒、合計 ≤ 15 秒
string
単一の参照音声(
audio_urls の単値形式)string
参照ドキュメント URL、最大 1 個。
link_url と同時指定不可。対応形式:docx / doc / xlsx / xls / pptx / ppt / pdf / txt / key / pages / numbers / md など、≤100MB、≤50 ページ。string
公開 Web ページ URL、最大 1 個。ログイン不要のページのみ。
file_url と同時指定不可。メディア族の相互排他
メディアは 2 族のいずれかで、混在不可(送信前に検証 → 400、タスク未作成・課金なし):素の image_urls の割当
generation_typeが指定されている → それに従う(frame/reference)- 未指定だが、リクエストに参照族入力がある(
video_urls/audio_urls/audio_url/file_url/link_url)→reference_imageとして扱う - どちらでもない → フレーム族:1 枚目
first_frame、2 枚目last_frame(wan2.7と同じ)
image_with_roles を使用してください。
メディア上限と形式
リクエスト例
テキストから動画
先頭フレームから動画
先頭・最終フレーム
image_with_roles を使用:
マルチモーダル参照
video_urlsがある場合、素のimage_urlsは参照画像に自動分類されます。generation_type: "reference"を明示するとより明確です。
ファイル参照から動画
prompt は省略可。ドキュメント内容で生成が駆動されます:
Web ページ参照から動画
課金
秒数 × 解像度(公式リスト価格に準拠)。音声のオン/オフは価格に影響しません:- デフォルトは 1080P(最上位価格)。コスト重視なら
480P/720Pを指定 - 課金秒数 = リクエストの
duration audio: true/falseは価格に影響しません
制限と注意
よくあるエラー
いずれも同期 400(タスク未作成・課金なし):Response
integer
ステータスコード。成功時は 200
array
レスポンスデータ配列
結果の照会動画生成は非同期です。タスク状態の取得 または
GET /v1/videos/generations/{task_id} でポーリングしてください。推奨間隔は 5–10 秒。生成には通常 1–5 分かかります。成功後は result.videos 内の URL を使用します。