Skip to main content

Wan3.0 - 動画生成 API リファレンス

Wan3.0 はオールインワンのリファレンスベース動画生成モデルで、 テキストから動画へ 、 画像から動画へ （先頭フレーム／先頭・末尾フレーム）、および リファレンスベース動画生成 をサポートします。最大 30 秒の動画を生成できます。現在 プレビュー 段階です。

前提条件

API 呼び出しが成功するようにするには、モデル、エンドポイント URL、および API キーがすべて同一リージョンに属していることを確認してください。リージョンをまたいだ呼び出しは失敗します。
  • モデルを選択：モデルギャラリーにアクセスしてモデルを選択し、そのモデルが属するリージョンを確認します。
  • URL を選択：対応するリージョンのエンドポイント URL を選択します。
  • API キーを設定：リージョンを選択し、API キーを取得した後、API キーを環境変数として設定します。
本トピックのサンプルコードはシンガポールリージョン向けです。

HTTP 呼び出し

動画生成タスクは比較的長い時間（通常 1～5 分）を要するため、API は非同期呼び出しを使用します。全体のプロセスは以下のとおり、「タスク作成 → 結果のポーリング」という 2 つのコアステップで構成されます。

ステップ 1：タスクを作成し、タスク ID を取得

  • シンガポール
  • 北京
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
  • タスク作成後は、返された task_id を使用して結果をクエリします。task_id の有効期間は 24 時間です。重複するタスクを作成しないでください。代わりに、ポーリングを使用して結果を取得してください。
  • 初心者向けのガイドについては、「Postman または cURL による API 呼び出し」をご参照ください。

リクエストパラメーター

リクエストヘッダー (Headers)
Content-Type string (必須)リクエストのコンテンツタイプ。必ず application/json にしてください。Authorization string (必須)Model Studio API キーを使用してリクエストを認証します。例：Bearer sk-xxxx。X-DashScope-Async string (必須)非同期処理を有効にします。HTTP リクエストでは非同期呼び出しのみサポートされます。必ず enable にしてください。
このリクエストヘッダーが存在しない場合、「current user api does not support synchronous calls」というエラーが返されます。
リクエスト本文 (Request Body)
model string (必須)モデル名。固定値：wan3.0-video。input object (必須)基本的な入力情報。prompt または media のいずれか一方を提供する必要があります。

プロパティ

prompt string (条件付き必須)目的の動画コンテンツを記述するテキストプロンプト。media またはこのパラメーターのいずれか一方を提供する必要があります。中国語および英語の両方をサポートします。中国語の各文字または英字は 1 文字としてカウントされ、最大 20,000 文字まで入力可能です。この制限を超えるコンテンツは自動的に切り捨てられます。リファレンスモードでは、プロンプト内で「Image 1」や「Video 1」などを使用して、media 配列内の対応する順序のメディアアセットを参照できます。media array (条件付き必須)画像、動画、音声、ファイル、ウェブページを入力として受け付けるメディアアセット配列。prompt またはこのパラメーターのいずれか一方を提供する必要があります。
  • 配列内の各要素は、type および url フィールドを含むメディアオブジェクトです。
  • リファレンスベース動画生成モードでは、配列の順序が prompt 内でのアセットの参照順序を定義します。画像と動画は別々にカウントされるため、「Image 1」と「Video 1」を同時に使用できます。
    • 配列内の 1 番目の reference_video は Video 1、2 番目は Video 2 に対応します。
    • 配列内の 1 番目の reference_image は Image 1、2 番目は Image 2 に対応します。
    • 配列内の 1 番目の reference_audio は Audio 1、2 番目は Audio 2 に対応します。

プロパティ

type string (必須)メディアアセットのタイプ。有効な値：
  • first_frame：先頭フレーム画像。最大 1 枚。動画の先頭フレームとして厳密に使用されます。
  • last_frame：末尾フレーム画像。最大 1 枚。動画の末尾フレームとして厳密に使用されます。
  • reference_image：リファレンス画像。最大 10 枚。
  • reference_video：リファレンス動画。最大 5 クリップで、合計持続時間は 15 秒以内。
  • reference_audio：リファレンス音声。最大 5 クリップで、合計持続時間は 15 秒以内。
  • file：ファイル。最大 1 ファイル。link とは同時に使用できません。
  • link：ウェブリンク。最大 1 リンク。file とは同時に使用できません。
reference_xx/file/link タイプと first_frame/last_frame タイプは相互排他であり、同一リクエスト内で同時に使用することはできません。
url string (必須)メディアアセットの URL または Base64 エンコードデータ。

入力画像 (type=first_frame / last_frame / reference_image)

画像の URL または Base64 エンコードデータ。画像の制限事項：
  • フォーマット：JPEG、JPG、PNG（透明チャンネルはサポートされません）、BMP、WEBP。
  • 解像度：各辺 [240、8000] ピクセル。
  • 縦横比：最大 8:1。
  • ファイルサイズ：最大 20 MB。
サポートされる入力形式：
  1. 公開 URL：
  2. Base64 エンコード画像文字列：
    • データ形式：data:{MIME_type};base64,{base64_data}。
    • 例：data:image/png;base64,GDU7MtCZzEbTbmRZ......（エンコードされた文字列は長いため、一部のみ表示）
    • 詳細については、「入力画像」をご参照ください。

入力動画 (type=reference_video)

リファレンス動画の URL。動画の制限事項：
  • フォーマット：mp4、mov。
  • 持続時間：1 クリップあたり [1、15] 秒で、合計持続時間は 15 秒以内。
  • フレームレート：≥16 fps。
  • 解像度：各辺 [240、4096] ピクセル。
  • 縦横比：最大 8:1。
  • 1 クリップあたりのファイルサイズ：最大 100 MB。
サポートされる入力形式：
  1. 公開 URL：

入力音声 (type=reference_audio)

リファレンス音声の URL。音声の制限事項：
  • フォーマット：wav、mp3。
  • 持続時間：1 クリップあたり [1、15] 秒で、合計持続時間は 15 秒以内。
  • ファイルサイズ：最大 15 MB。
サポートされる入力形式：
  1. 公開 URL：

入力ファイル (type=file)

ファイルの URL。ファイルの制限事項：
  • フォーマット：docx、doc、xlsx、xls、pptx、ppt、pdf、txt、key、pages、numbers、md。
  • ファイルサイズ：最大 100 MB。
  • ページ数制限：最大 50 ページ（pdf、docx、doc、pptx、ppt、key、pages 形式に対して検証済み）。
サポートされる入力形式：
  1. 公開 URL：

入力ウェブリンク (type=link)

parameters object (任意)動画処理パラメーター。

プロパティ

resolution string (任意)生成される動画の解像度レベル。デフォルト値：1080P。有効な値：
  • 1080P
  • 720P
  • 480P
ratio string (任意)生成される動画の縦横比。有効な値：
  • adaptive（デフォルト値）：入力メディアの比率および意図に基づいて適切な縦横比を自動推奨するアダプティブ縦横比。
  • 21:9
  • 16:9
  • 4:3
  • 1:1
  • 3:4
  • 9:16
duration integer (任意)生成される動画の持続時間（秒単位）。デフォルト値：5。
  • 動画入力なしの場合：[2、30] の範囲の整数。
  • 動画入力ありの場合：入力動画の合計持続時間＋出力動画の持続時間が 30 秒を超えてはなりません。
  • -1 に設定した場合：スマート持続時間モード。モデルが入力プロンプト、コンテンツ、リッチメディアに基づいて適切な持続時間を自動推奨します。
audio boolean (任意)出力動画に音声を含めるかどうか。
  • true：デフォルト値。出力動画に音声が含まれます。
  • false：出力動画に音声トラックが含まれません。
音声の有効化または無効化は課金に影響しません。seed integer (任意)乱数シード。生成結果を再現するために使用します。値の範囲：-1または[0、2147483647]。-1を指定するか未指定の場合、システムが自動的にランダムシードを生成します。同じseedを使用しても、毎回同一の結果が生成されるとは限りません。watermark boolean (任意)ウォーターマークを追加するかどうか。
  • false：デフォルト値。ウォーターマークは追加されません。
  • true：ウォーターマークが追加されます。
  • ファイルから動画への参照
  • リファレンスベース動画生成
  • テキストから動画生成
  • 先頭フレームから動画生成
  • 先頭・末尾フレームから動画生成
file タイプでファイルを渡すと、モデルが自動的にファイルの内容を理解して動画を生成します。
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "wan3.0-video",
    "input": {
        "prompt": "A high-end smart glasses product advertisement with a minimalist, futuristic, and fashionable style. The color palette features black, silver-gray, and ice-blue tones with subtle white light accents and parameter UI graphics. Opening in pure black background, a pair of smart glasses slowly emerges from darkness with refined highlights on the temple edges. The camera captures ultra-close details of lenses, nose pads, hinges, temples, and material textures, showcasing metal and high-performance composite materials. The product then rotates slowly in mid-air with minimalist motion graphics displaying core parameters. Then the camera pulls back as all parts precisely reassemble into the complete product, transitioning to a young model wearing demonstration in minimalist spaces and urban lighting environments.",
        "media": [
            {
                "type": "file",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260806/ebapmr/glass.pptx"
            }
        ]
    },
    "parameters": {
        "resolution": "480P",
        "ratio": "adaptive",
        "duration": 10
    }
}'

レスポンスパラメーター

output objectタスク出力情報。

プロパティ

task_id stringタスク ID。クエリの有効期間は 24 時間です。task_status stringタスクのステータス。

列挙値

  • PENDING
  • RUNNING
  • SUCCEEDED
  • FAILED
  • CANCELED
  • UNKNOWN：タスクが存在しない、またはステータスが不明です。
request_id stringトレースおよびトラブルシューティング用の一意のリクエスト識別子。code stringエラーコード。失敗したリクエストの場合にのみ返されます。「エラーコード」をご参照ください。message string詳細なエラーメッセージ。失敗したリクエストの場合にのみ返されます。「エラーコード」をご参照ください。
  • 成功時のレスポンス
  • エラー時のレスポンス
task_id を保存して、タスクのステータスおよび結果をクエリします。
{
    "output": {
        "task_status": "PENDING",
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
    },
    "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

ステップ 2：タスク ID で結果をクエリ

  • シンガポール
  • 北京
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}
  • ポーリングの推奨：動画生成には数分かかります。15 秒などの適切な間隔でポーリングメカニズムを使用してください。
  • タスク状態遷移：PENDING → RUNNING → SUCCEEDED または FAILED。
  • 結果リンク：タスクが成功すると、24 時間有効な動画 URL が返されます。動画をダウンロードして、OSS などの永続ストレージに保存してください。
  • task_idの有効期間：24 時間。この期間を過ぎると、クエリの結果は UNKNOWN になります。

リクエストパラメーター

リクエストヘッダー (Headers)
Authorization string (必須)Model Studio API キーを使用してリクエストを認証します。例：Bearer sk-xxxx。
URL パスパラメーター (Path parameters)
task_id string (必須)タスクの ID。
  • タスク結果のクエリ
{task_id} を前回の API 呼び出しで返された task_id 値に置き換えます。task_id のクエリ有効期間は 24 時間です。{WorkspaceId} を実際のワークスペース IDに置き換えてください。
curl -X GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

レスポンスパラメーター

output objectタスク出力情報。

プロパティ

task_id string (必須)タスクの ID。task_status stringタスクステータス。

列挙値

  • PENDING
  • RUNNING
  • SUCCEEDED
  • FAILED
  • CANCELED
  • UNKNOWN：タスクが存在しない、またはステータスが不明です。
submit_time stringタスクが送信された時刻。時刻は UTC + 08:00 で、形式は YYYY-MM-DD HH:mm:ss.SSS です。scheduled_time stringタスクが実行された時刻。時刻は UTC + 08:00 で、形式は YYYY-MM-DD HH:mm:ss.SSS です。end_time stringタスクが完了した時刻。時刻は UTC + 08:00 で、形式は YYYY-MM-DD HH:mm:ss.SSS です。orig_prompt string元の入力プロンプト。video_url string生成された動画の URL。タスクが成功した場合に返されます。動画形式は MP4 (H.264 エンコード) です。code stringエラーコード。失敗したリクエストの場合にのみ返されます。「エラーコード」をご参照ください。message string詳細なエラーメッセージ。失敗したリクエストの場合にのみ返されます。「エラーコード」をご参照ください。
usage object出力統計情報。成功した結果のみをカウントします。

プロパティ

video_count integer生成された動画の数。固定値：1。duration float動画の合計時間（秒単位）。入力参考動画がない場合は出力動画の時間と等しく、入力参考動画がある場合は入力動画の時間と出力動画の時間の合計となります。input_video_duration float入力動画の持続時間（秒単位）。動画が入力として提供されていない場合は 0.0 を返します。output_video_duration float出力動画の持続時間（秒単位）。fps integer生成された動画のフレームレート。SR integer生成された動画の解像度。例：720。ratio string生成された動画の縦横比。例：16:9。
request_id stringトレースおよびトラブルシューティング用の一意のリクエスト識別子。
  • タスク成功
  • タスク失敗
  • タスククエリ期限切れ
動画 URL の有効期間は 24 時間のみで、その後自動的にパージされます。生成された動画は速やかに保存してください。
{
    "request_id": "78c9b768-0285-996c-b682-xxxxxx",
    "output": {
        "task_id": "17ed7e50-00cf-4509-aea1-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2026-08-06 10:01:35.452",
        "scheduled_time": "2026-08-06 10:01:35.507",
        "end_time": "2026-08-06 10:13:33.838",
        "orig_prompt": "A golden retriever running on a sunny beach, waves crashing in the background, cinematic lighting",
        "video_url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx/video.mp4"
    },
    "usage": {
        "video_count": 1,
        "duration": 5.0,
        "input_video_duration": 0.0,
        "output_video_duration": 5.0,
        "fps": 30,
        "SR": 720,
        "ratio": "16:9"
    }
}