すべてのプロダクト
Search
ドキュメントセンター

Alibaba Cloud Model Studio:Wan3.0 - 動画生成 API リファレンス

最終更新日:Aug 08, 2026

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

北京

POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis

説明
  • タスク作成後は、返された task_id を使用して結果をクエリします。task_id の有効期間は 24 時間です。重複するタスクを作成しないでください。代わりに、ポーリングを使用して結果を取得してください。

  • 初心者向けのガイドについては、「Postman または cURL による API 呼び出し」をご参照ください。

リクエストパラメーター

ファイルから動画への参照

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
    }
}'

リファレンスベース動画生成

input.media にリファレンス画像、動画、音声、ファイル、またはウェブリンクを渡すと、モデルが自動的に意図を理解して動画を生成します。

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": "Video 1 holds Image 3 and plays a soothing country folk song on the chair in Image 4, saying: '\''The sunshine is so nice today.'\'' Image 1 holds Image 2, passes by Video 1, places Image 2 on the table next to Video 1, and says: '\''That sounds beautiful, can you sing it again?'\''",
        "media": [
            {
                "type": "reference_image",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260408/sjuytr/wan-r2v-object-girl.jpg"
            },
            {
                "type": "reference_video",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qigswt/wan-r2v-role2.mp4"
            },
            {
                "type": "reference_image",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/rtjeqf/wan-r2v-object3.png"
            },
            {
                "type": "reference_image",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qpzxps/wan-r2v-object4.png"
            },
            {
                "type": "reference_image",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/wfjikw/wan-r2v-backgroud5.png"
            }
        ]
    },
    "parameters": {
        "resolution": "480P",
        "ratio": "adaptive",
        "duration": 5
    }
}'

テキストから動画生成

prompt のみを使用して動画を生成し、メディアファイルは一切渡しません。

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 kitten running on a rooftop under the moonlight, neon lights of the city flickering in the distance, cinematic quality, smooth camera movement."
    },
    "parameters": {
        "resolution": "480P",
        "ratio": "adaptive",
        "duration": 5
    }
}'

先頭フレームから動画生成

first_frame を使用して、動画の先頭フレーム画像を厳密に指定します。

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": "An urban fantasy art scene. A dynamic graffiti art character. A spray-painted teenager coming to life from a concrete wall. He raps at an extremely fast pace while striking a classic, energetic rapper pose. The scene is set under a railway bridge at night with an urban vibe. Lighting comes from a solitary streetlamp, creating a cinematic atmosphere full of high energy and stunning detail. The audio of the video consists entirely of rap, with no other dialogue or noise.",
        "media": [
            {
                "type": "first_frame",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png"
            }
        ]
    },
    "parameters": {
        "resolution": "480P",
        "ratio": "adaptive",
        "duration": 5
    }
}'

先頭・末尾フレームから動画生成

first_frame および last_frame の両方を渡して、動画の先頭フレームおよび末尾フレーム画像を厳密に指定します。

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 young girl gradually transitions from a smile to laughter, the camera slowly pushing in, background lighting shifting from cool to warm tones.",
        "media": [
            {
                "type": "first_frame",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png"
            },
            {
                "type": "last_frame",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260408/sjuytr/wan-r2v-object-girl.jpg"
            }
        ]
    },
    "parameters": {
        "resolution": "480P",
        "ratio": "adaptive",
        "duration": 5
    }
}'
リクエストヘッダー (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_videoVideo 1、2 番目は Video 2 に対応します。

    • 配列内の 1 番目の reference_imageImage 1、2 番目は Image 2 に対応します。

    • 配列内の 1 番目の reference_audioAudio 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:

    • HTTP または HTTPS プロトコルをサポートします。

    • 例:https://xxx/xxx.png。

  2. Base64 エンコード画像文字列:

    • データ形式:data:{MIME_type};base64,{base64_data}

    • 例:data:image/png;base64,GDU7MtCZzEbTbmRZ......(エンコードされた文字列は長いため、一部のみ表示)

    • 詳細については、「入力画像」をご参照ください。

入力動画 (type=reference_video)

リファレンス動画の URL。

動画の制限事項:

  • フォーマット:mp4、mov。

  • 持続時間:1 クリップあたり [1、15] 秒で、合計持続時間は 15 秒以内。

  • 解像度:各辺 [240、4096] ピクセル。

  • 縦横比:最大 8:1。

  • 1 クリップあたりのファイルサイズ:最大 100 MB。

サポートされる入力形式:

  1. 公開 URL:

    • HTTP または HTTPS プロトコルをサポートします。

    • 例:https://xxx/xxx.mp4。

入力音声 (type=reference_audio)

リファレンス音声の URL。

音声の制限事項:

  • フォーマット:wav、mp3。

  • 持続時間:1 クリップあたり [1、15] 秒で、合計持続時間は 15 秒以内。

  • ファイルサイズ:最大 15 MB。

サポートされる入力形式:

  1. 公開 URL:

    • HTTP または HTTPS プロトコルをサポートします。

    • 例:https://xxx/xxx.mp3。

入力ファイル (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:

    • HTTP または HTTPS プロトコルをサポートします。

    • 例:https://xxx/xxx.pdf。

parameters object (任意)

動画処理パラメーター。

プロパティ

resolution string (任意)

生成される動画の解像度レベル。デフォルト値:1080P。有効な値:

  • 1080P

  • 720P

  • 480P

ratio string (任意)

生成される動画の縦横比。有効な値:

  • adaptive(デフォルト値):入力メディアの比率および意図に基づいて適切な縦横比を自動推奨するアダプティブ縦横比。

  • 16:9

  • 4:3

  • 1:1

  • 3:4

  • 9:16

duration integer (任意)

生成される動画の持続時間(秒単位)。デフォルト値:5。

  • 動画入力なしの場合:[2、30] の範囲の整数。

  • 動画入力ありの場合:入力動画の合計持続時間+出力動画の持続時間が 30 秒を超えてはなりません。

  • -1 に設定した場合:スマート持続時間モード。モデルが入力プロンプト、コンテンツ、リッチメディアに基づいて適切な持続時間を自動推奨します。

audio boolean (任意)

出力動画に音声を含めるかどうか。

  • true:デフォルト値。出力動画に音声が含まれます。

  • false:出力動画に音声トラックが含まれません。

音声の有効化または無効化は課金に影響しません。

seed integer (任意)

乱数シード。生成結果を再現するために使用します。値の範囲:[0、2147483647]。

watermark boolean (任意)

ウォーターマークを追加するかどうか。

  • false:デフォルト値。ウォーターマークは追加されません。

  • true:ウォーターマークが追加されます。

レスポンスパラメーター

成功時のレスポンス

task_id を保存して、タスクのステータスおよび結果をクエリします。

{
    "output": {
        "task_status": "PENDING",
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
    },
    "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

エラー時のレスポンス

タスク作成に失敗しました。「エラーコード」をご参照ください。

{
    "code": "InvalidApiKey",
    "message": "No API-key provided.",
    "request_id": "7438d53d-6eb8-4596-8835-xxxxxx"
}

output object

タスク出力情報。

プロパティ

task_id string

タスク ID。クエリの有効期間は 24 時間です。

task_status string

タスクのステータス。

列挙値

  • PENDING

  • RUNNING

  • SUCCEEDED

  • FAILED

  • CANCELED

  • UNKNOWN:タスクが存在しない、またはステータスが不明です。

request_id string

トレースおよびトラブルシューティング用の一意のリクエスト識別子。

code string

エラーコード。失敗したリクエストの場合にのみ返されます。「エラーコード」をご参照ください。

message string

詳細なエラーメッセージ。失敗したリクエストの場合にのみ返されます。「エラーコード」をご参照ください。

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

シンガポール

GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}

北京

GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/{task_id}

説明
  • ポーリングの推奨:動画生成には数分かかります。15 秒などの適切な間隔でポーリングメカニズムを使用してください。

  • タスク状態遷移:PENDING → RUNNING → SUCCEEDED または FAILED。

  • 結果リンク:タスクが成功すると、24 時間有効な動画 URL が返されます。動画をダウンロードして、OSS などの永続ストレージに保存してください。

  • task_id の有効期間24 時間。この期間を過ぎると、クエリの結果は UNKNOWN になります。

リクエストパラメーター

タスク結果のクエリ

{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"
リクエストヘッダー (Headers)

Authorization string (必須)

Model Studio API キーを使用してリクエストを認証します。例:Bearer sk-xxxx。

URL パスパラメーター (Path parameters)

task_id string (必須)

タスクの ID。

レスポンスパラメーター

タスク成功

動画 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"
    }
}

タスク失敗

タスクが失敗した場合、task_status は FAILED となり、エラーコードおよびメッセージが返されます。「エラーコード」をご参照ください。

{
    "request_id": "e5e57877-c0fc-47ed-8fad-xxxxxx",
    "output": {
        "task_id": "eff1443c-ccab-4676-aad3-xxxxxx",
        "task_status": "FAILED",
        "code": "InvalidParameter",
        "message": "The two modes are mutually exclusive. Do not pass reference_xx and first_frame/last_frame at the same time."
    }
}

タスククエリ期限切れ

task_id の有効期間は 24 時間です。この期間を過ぎると、以下のエラーが返されます。

{
    "request_id": "a4de7c32-7057-9f82-8581-xxxxxx",
    "output": {
        "task_id": "502a00b1-19d9-4839-a82f-xxxxxx",
        "task_status": "UNKNOWN"
    }
}

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。タスクが成功した場合に返されます。

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

トレースおよびトラブルシューティング用の一意のリクエスト識別子。