Skip to main content

Wan2.7 - text-to-video API リファレンス

Wan テキスト動画生成モデルは、 テキストプロンプト からスムーズな動画を生成します。

リファレンス: ユーザーガイド

可用性

モデル、エンドポイント URL、API キーのリージョンを一致させてください。リージョンをまたいだ呼び出しは失敗します。
  • モデルの選択:モデルスクエアに移動してモデルを選択し、そのリージョンを確認します。
  • URL の選択:対応するリージョンのエンドポイント URL を使用します。HTTP と HTTPS の両方がサポートされています。
  • API キーの設定:リージョンを選択し、API キーを取得し、環境変数に設定します。
  • SDK のインストール:SDK を介して API を呼び出すには、DashScope SDK をインストールします。
このトピックのサンプルコードでは、シンガポールリージョンを使用しています。
Alibaba Cloud Model Studio は、中国 (北京) およびシンガポールリージョン向けにワークスペース固有のドメインをリリースしました。新しい専用ドメインは、推論リクエストに対して優れたパフォーマンスと高い安定性を提供します。新しいドメインへの移行を推奨します:
  • 中国 (北京):https://dashscope.aliyuncs.com から https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com へ
  • シンガポール:https://dashscope-intl.aliyuncs.com から https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com へ
{WorkspaceId} はワークスペース ID であり、Alibaba Cloud Model Studio コンソールの [ワークスペース詳細] ページで確認できます。既存のドメインも引き続き完全に機能します。

HTTP (wan2.7)

このインターフェイスは新しいプロトコルを使用し、wan2.7 のみをサポートします。
テキスト動画生成タスクには 1~5 分かかります。API は非同期呼び出しを使用します:タスクを作成 → 結果をポーリング。

ステップ 1:タスクの作成

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

リクエストパラメーター

  • マルチショットナラティブ
  • 音声ファイルの提供
  • 自動ダビング
  • ネガティブプロンプトの使用
prompt 内の自然言語でショット構造を制御します。shot_type パラメーターは効果がありません。
  • シングルショット:「シングルショットビデオを生成」と入力します。
  • マルチショット:「マルチショットビデオを生成」と入力するか、タイムスタンプ付きでショットを記述します (例:「ショット 1 [0–3 秒] ワイドショット:夜の雨のニューヨークの通り」)。
  • デフォルト:指定しない場合、モデルは 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": "wan2.7-t2v-2026-06-12",
        "input": {
            "prompt": "映画的なストーリーテリングによる緊迫した探偵物語。ショット 1 [0–3 秒] ワイドショット:夜の雨のニューヨークの通り、ネオンが点滅し、黒いトレンチコートの探偵が早足で歩く。ショット 2 [3–6 秒] ミディアムショット:探偵が古い建物に入り、雨がコートを濡らし、ドアがゆっくりと閉まる。ショット 3 [6–9 秒] クローズアップ:探偵の集中した目、遠くでサイレンが鳴り、彼はわずかに眉をひそめる。ショット 4 [9–12 秒] ミディアムショット:探偵が薄暗い廊下を慎重に進み、懐中電灯が道を照らす。ショット 5 [12–15 秒] クローズアップ:探偵が重要な手がかりを発見し、彼の顔に突然の気づきが浮かぶ。"
        },
        "parameters": {
            "resolution": "720P",
            "ratio": "16:9",
            "prompt_extend": true,
            "watermark": true,
            "duration": 15
        }
    }'
ヘッダー
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」というエラーが返されます。
リクエストボディ
model string (必須)モデル名。モデルと料金については、「モデルの料金」をご参照ください。例:wan2.7-t2v, wan2.7-t2v-2026-06-12。
input object (必須)プロンプトを含む入力データ。

プロパティ

prompt string (必須)ビデオのコンテンツと視覚スタイルを記述するテキストプロンプト。中国語と英語をサポートします。各文字または手紙は 1 つとしてカウントされます。制限を超えるテキストは自動的に切り捨てられます。モデルごとの最大長:
  • wan2.7-t2v, wan2.7-t2v-2026-06-12:最大 5,000 文字。
例:月明かりの中を走る子猫。ヒントについては、「テキスト動画生成/画像動画生成プロンプトガイド」をご参照ください。negative_prompt string (任意)生成されたビデオから除外する要素。中国語と英語をサポートします。最大 500 文字。長いテキストは自動的に切り捨てられます。例:低解像度、エラー、最悪の品質、低品質、変形、余分な指、悪いプロポーション。audio_url string (任意)ビデオ生成用の音声ファイルの URL。サポートされているフォーマット:
  1. パブリック URL:
音声の制限:
  • フォーマット:WAV, MP3。
  • 持続時間:2~30 秒。
  • ファイルサイズ:最大 15 MB。
  • 持続時間の処理:音声が duration の値 (たとえば 5 秒) を超える場合、最初の 5 秒のみが使用されます。音声がビデオより短い場合、残りのビデオは無音になります。たとえば、5 秒のビデオに 3 秒の音声を使用すると、3 秒の音声の後に 2 秒の無音が生じます。
parameters object (任意)ビデオ生成パラメーター:解像度、プロンプトリライト、ウォーターマーク。

プロパティ

resolution string (任意)
解像度はコストに影響します。呼び出す前に「モデルの料金」を確認してください。
生成されるビデオの解像度レベル。出力の鮮明さ (総ピクセル数) を制御します。
  • wan2.7-t2v, wan2.7-t2v-2026-06-12:有効な値:720P, 1080P。デフォルト:1080P。
ratio string (任意)出力ビデオのアスペクト比。
  • 16:9 (デフォルト)
  • 9:16
  • 1:1
  • 4:3
  • 3:4
アスペクト比ごとの出力解像度 (幅*高さ):

解像度レベル

アスペクト比

出力ビデオ解像度 (幅*高さ)

720P

16:9

1280*720

9:16

720*1280

1:1

960*960

4:3

1104*832

3:4

832*1104

1080P

16:9

1920*1080

9:16

1080*1920

1:1

1440*1440

4:3

1648*1248

3:4

1248*1648

duration integer (任意)
持続時間はコストに影響します。課金は秒単位です。呼び出す前に「モデルの料金」を確認してください。
出力ビデオの持続時間 (秒)。
  • wan2.7-t2v, wan2.7-t2v-2026-06-12:2 から 15 までの整数。デフォルト:5。
prompt_extendboolean (任意)プロンプトリライトを有効にします。有効にすると、LLM が入力プロンプトを書き換えて生成品質を向上させます。短いプロンプトに最適ですが、レイテンシが増加します。
  • true (デフォルト)
  • false
watermark boolean (任意)右下隅に「AI Generated」というテキストのウォーターマークを追加します。
  • false (デフォルト)
  • true
seed integer (任意)乱数シードは [0, 2147483647] の範囲の整数である必要があります。指定しない場合、ランダムなシードが生成されます。固定シードは再現性を向上させます。モデルの生成は確率的であるため、同じシードが同一の結果を保証するわけではありません。

レスポンスパラメーター

  • 成功した応答
  • エラー応答
task_id を保存して、タスクのステータスと結果をクエリします。
{
    "output": {
        "task_status": "PENDING",
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
    },
    "request_id": "4909100c-7b5a-9f92-bfe5-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:結果のクエリ

  • 北京
  • シンガポール
GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/{task_id}
  • シンガポール
  • 北京
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}
{WorkspaceId} を実際のワークスペース 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"
ヘッダー
Authorization string (必須)Model Studio API キーでリクエストを認証します。例:Bearer sk-xxxx。
パスパラメーター
task_id string (必須)タスクの ID。

レスポンスパラメーター

  • タスクの正常実行
  • タスク実行の失敗
  • タスククエリの有効期限切れ
ビデオ URL は 24 時間のみ有効で、その後自動的に消去されます。生成されたビデオは速やかに保存してください。
{
    "request_id": "caa62a12-8841-41a6-8af2-xxxxxx",
    "output": {
        "task_id": "eff1443c-ccab-4676-aad3-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2025-09-29 14:18:52.331",
        "scheduled_time": "2025-09-29 14:18:59.290",
        "end_time": "2025-09-29 14:23:39.407",
        "orig_prompt": "壮大でかわいいシーン。精巧な金の鎧と少し大きすぎるヘルメットを身に着けた、小さくて愛らしい漫画の子猫の将軍が、崖の上に勇敢に立っている。彼は小さくも英雄的な軍馬に乗り、「青海の長い雲が雪山を暗くし、孤立した都市が遠く玉門関を望む。黄砂の中での百戦を経て、金の鎧はすり減ったが、楼蘭を破るまでは帰らない」と言う。崖の下では、間に合わせの武器を持った広大で無限のネズミの軍隊が突撃している。これは古代中国の戦争叙事詩に触発された、ドラマチックで大規模な戦闘シーンである。遠くには、雪山の上の空に暗い雲が集まっている。全体の雰囲気は、「かわいい」と「威圧的」のコミカルで壮大な融合である。",
        "video_url": "https://dashscope-result-sh.oss-accelerate.aliyuncs.com/xxx.mp4?Expires=xxx"
    },
    "usage": {
        "duration": 10,
        "input_video_duration": 0,
        "output_video_duration": 10,
        "video_count": 1,
        "ratio": "16:9",
        "SR": 720
    }
}
outputobjectタスクの出力。

プロパティ

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

列挙値

  • PENDING
  • RUNNING
  • SUCCEEDED
  • FAILED
  • CANCELED
  • UNKNOWN:タスクが存在しないか、ステータスが不明です。
ポーリング中の状態遷移:
  • PENDING → RUNNING → SUCCEEDED または FAILED。
  • 初期クエリのステータスは通常 PENDING または RUNNING です。
  • ステータスが SUCCEEDED に変わると、レスポンスには生成されたビデオの URL が含まれます。
  • ステータスが FAILED の場合は、エラーメッセージを確認してタスクをリトライしてください。
submit_time stringタスクが送信された時刻。時刻は UTC+8 で、フォーマットは YYYY-MM-DD HH:mm:ss.SSS です。scheduled_time stringタスクが実行された時刻。時刻は UTC+8 で、フォーマットは YYYY-MM-DD HH:mm:ss.SSS です。end_time stringタスクが完了した時刻。時刻は UTC+8 で、フォーマットは YYYY-MM-DD HH:mm:ss.SSS です。video_url string生成されたビデオの URL。task_status が SUCCEEDED の場合にのみ返されます。24 時間有効です。ビデオは H.264 エンコーディングの MP4 フォーマットです。orig_prompt string元の入力プロンプト。リクエストパラメーター prompt に対応します。code stringエラーコード。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。message string詳細なエラーメッセージ。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。
usage object出力統計。成功したタスクに対してのみ返されます。

プロパティ

duration float課金に使用される総ビデオ持続時間。output_video_duration と等しい。input_video_duration integer固定値:0。output_video_duration integer出力ビデオの持続時間 (秒)。input.duration の値と一致します。SR integer出力ビデオの解像度レベル。例:720。ratio string出力ビデオのアスペクト比。例:16:9。video_count integer生成されたビデオの数。常に 1 です。
request_id stringトレースとトラブルシューティングのための一意のリクエスト識別子。

HTTP (wan2.6 以前)

このインターフェイスはレガシープロトコルを使用し、wan2.6 以前 (wan2.5/wan2.2/wan2.1) をサポートします。
テキスト動画生成タスクには 1~5 分かかるため、API は非同期呼び出しを使用します:タスクを作成 → 結果をポーリング。

ステップ 1:タスクの作成

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

リクエストパラメーター

  • マルチショットナラティブ
  • 音声ファイルを渡す
  • 自動ダビング
  • 無音ビデオの生成
  • ネガティブプロンプトの使用
  • マルチショットナラティブを作成するには、shot_type を "multi" に設定します。
  • prompt_extend を true に設定して、ストーリーボードの最適化のためにプロンプトリライトを有効にします。
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": "wan2.6-t2v",
        "input": {
            "prompt": "ローアングルからのショット、ミディアムクローズアップ、暖かいトーン、混合照明 (デスクランプからの実用的な光が窓からの曇り空の光と混ざり合う)、サイドライティング、中央構図。クラシックな探偵事務所で、木製の本棚には古い事件ファイルと灰皿が詰まっている。緑のデスクランプが机の中央に広げられた事件ファイルを照らしている。濃い茶色のトレンチコートと薄い灰色のフェドーラ帽をかぶったキツネが革椅子に座り、その毛皮は深紅色で、尾は軽く端に置かれ、指はゆっくりと黄ばんだページをめくっている。外では、青い空の下で絶え間ない霧雨が降り、ガラスに曲がりくねった筋を残している。彼はゆっくりと頭を上げ、耳がわずかにぴくぴく動き、琥珀色の目がカメラをまっすぐに見つめ、口がはっきりと動いて滑らかで皮肉な声で話す:「事件は冷え切っていた、冬の魚よりも冷たく。しかし、どんな鶏にも秘密はある。そして私は、その秘密を見つけ出すつもりだった」。",
            "audio_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250929/stjqnq/%E7%8B%90%E7%8B%B8.mp3"
        },
        "parameters": {
            "size": "1280*720",
            "prompt_extend": true,
            "duration": 10,
            "shot_type":"multi"
        }
    }'
リクエストヘッダー
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」というエラーが返されます。
リクエストボディ
model string (必須)モデル名。モデルと料金については、「モデルの料金」をご参照ください。例:wan2.6-t2v。
input object (必須)プロンプトを含む入力データ。

プロパティ

prompt string (必須)ビデオのコンテンツと視覚スタイルを記述するテキストプロンプト。中国語と英語をサポートします。各文字または手紙は 1 つとしてカウントされます。制限を超えるテキストは自動的に切り捨てられます。モデルごとの最大長:
  • wan2.6 および wan2.5 シリーズモデル:最大 1,500 文字。
  • wan2.2 および wan2.1 シリーズモデル:最大 800 文字。
例:月明かりの中を走る子猫。ヒントについては、「テキスト動画生成/画像動画生成プロンプトガイド」をご参照ください。negative_prompt string (任意)生成されたビデオから除外する要素。中国語と英語をサポートします。最大 500 文字。長いテキストは自動的に切り捨てられます。例:低解像度、エラー、最悪の品質、低品質、変形、余分な指、悪いプロポーション。audio_url string (任意)サポートされているモデル:wan2.6 および wan2.5 シリーズ。ビデオ生成用の音声ファイルの URL。サポートされているフォーマット:
  1. パブリック URL:
音声の制限:
  • フォーマット:WAV, MP3。
  • 持続時間:3 秒から 30 秒。
  • ファイルサイズ:最大 15 MB。
  • 持続時間の処理:音声が duration の値 (たとえば 5 秒) を超える場合、最初の 5 秒のみが使用されます。音声がビデオより短い場合、残りのビデオは無音になります。たとえば、5 秒のビデオに 3 秒の音声を使用すると、3 秒の音声の後に 2 秒の無音が生じます。
parameters object (任意)ビデオ生成パラメーター:解像度、プロンプトリライト、ウォーターマーク。

プロパティ

size string (任意)
  • size パラメーターはコストに影響します:コスト = 単価 (解像度ベース) x 持続時間 (秒)。同じモデルの場合:1080p > 720p > 480p。「モデルの料金」を確認してください。
  • size を特定の解像度 (たとえば 1280*720) に設定し、アスペクト比 (1:1) やティアラベル (480p) には設定しないでください。
出力ビデオの解像度を 幅*高さ 形式で指定します。デフォルト値と有効な値はモデルによって異なります:
  • wan2.6-t2v:デフォルト値は 1920*1080 (1080p) です。有効な解像度:720p および 1080p ティアのすべて。
  • wan2.6-t2v-us:デフォルト値は 1920*1080 (1080p) です。有効な解像度:720p および 1080p ティアのすべて。
  • wan2.5-t2v-preview:デフォルト値は 1920*1080 (1080p) です。有効な解像度:480p、720p、1080p ティアのすべて。
  • wan2.2-t2v-plus:デフォルト値は 1920*1080 (1080p) です。有効な解像度:480p および 1080p ティアのすべて。
  • wan2.1-t2v-turbo:デフォルト値は 1280*720 (720p) です。有効な解像度:480p および 720p ティアのすべて。
  • wan2.1-t2v-plus:デフォルト値は 1280*720 (720p) です。有効な解像度:720p ティアのすべて。
480p ティアの解像度とアスペクト比:
  • 832*480:16:9。
  • 480*832:9:16。
  • 624*624:1:1。
720p ティアの解像度とアスペクト比:
  • 1280*720:16:9。
  • 720*1280:9:16。
  • 960*960:1:1。
  • 1088*832:4:3。
  • 832*1088:3:4。
1080p ティアの解像度とアスペクト比:
  • 1920*1080:16:9。
  • 1080*1920:9:16。
  • 1440*1440:1:1。
  • 1632*1248:4:3。
  • 1248*1632:3:4。
duration integer (任意)
持続時間はコストに影響します:コスト = 単価 (解像度ベース) x 持続時間 (秒)。「モデルの料金」を確認してください。
出力ビデオの持続時間 (秒)。有効な値はモデルによって異なります:
  • wan2.6-t2v:2 から 15 までの整数。デフォルト値は 5 です。
  • wan2.6-t2v-us:有効な値は 5 と 10 です。デフォルト値は 5 です。
  • wan2.5-t2v-preview:有効な値は 5 と 10 です。デフォルト値は 5 です。
  • wan2.2-t2v-plus:5 秒に固定されており、変更できません。
  • wan2.1-t2v-plus:5 秒に固定されており、変更できません。
  • wan2.1-t2v-turbo:5 秒に固定されており、変更できません。
prompt_extendboolean (任意)プロンプトリライトを有効にします。有効にすると、LLM が入力プロンプトを書き換えて品質を向上させます。短いプロンプトに最適ですが、レイテンシが増加します。
  • true (デフォルト)
  • false
shot_type string (任意)サポートされているモデル:wan2.6 モデル。出力ビデオのショット構造:1 つの連続したショットまたはトランジション付きの複数のショット。有効な値:
  • single (デフォルト)
  • multi
このパラメーターは、"prompt_extend": true が設定されている場合にのみ有効です。優先度:shot_type はプロンプトをオーバーライドします。shot_type を single に設定すると、プロンプトがマルチショットを要求していてもシングルショットビデオが生成されます。watermark boolean (任意)右下隅に「AI Generated」というテキストのウォーターマークを追加します。
  • false (デフォルト)
  • true
seed integer (任意)乱数シードは [0, 2147483647] の範囲の整数である必要があります。指定しない場合、ランダムなシードが生成されます。固定シードは再現性を向上させます。モデルの生成は確率的であるため、同じシードが同一の結果を保証するわけではありません。

レスポンスパラメーター

  • 成功した応答
  • エラー応答
task_id を保存して、タスクのステータスと結果をクエリします。
{
    "output": {
        "task_status": "PENDING",
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
    },
    "request_id": "4909100c-7b5a-9f92-bfe5-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:結果のクエリ

  • シンガポール
  • バージニア
  • 北京
  • フランクフルト
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}
{WorkspaceId} を実際のワークスペース 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"
ヘッダー
Authorization string (必須)Model Studio API キーでリクエストを認証します。例:Bearer sk-xxxx。
パスパラメーター
task_id string (必須)タスクの ID。

レスポンスパラメーター

  • タスクの正常実行
  • タスク実行の失敗
  • タスククエリの有効期限切れ
ビデオ URL は 24 時間のみ有効で、その後自動的に消去されます。生成されたビデオは速やかに保存してください。
{
        "request_id": "abbf7aa3-9652-4785-a622-xxxxxx",
        "output": {
            "task_id": "38513c71-5190-48e1-9f3b-xxxxxx",
            "task_status": "SUCCEEDED",
            "submit_time": "2025-09-29 14:05:22.119",
            "scheduled_time": "2025-09-29 14:05:28.278",
            "end_time": "2025-09-29 14:10:00.437",
            "orig_prompt": "ローアングルからのショット、ミディアムクローズアップ、暖かいトーン、混合照明 (デスクランプからの実用的な光が窓からの曇り空の光と混ざり合う)、サイドライティング、中央構図。クラシックな探偵事務所で、木製の本棚には古い事件ファイルと灰皿が詰まっている。緑のデスクランプが机の中央に広げられた事件ファイルを照らしている。濃い茶色のトレンチコートと薄い灰色のフェドーラ帽をかぶったキツネが革椅子に座り、その毛皮は深紅色で、尾は軽く端に置かれ、指はゆっくりと黄ばんだページをめくっている。外では、青い空の下で絶え間ない霧雨が降り、ガラスに曲がりくねった筋を残している。彼はゆっくりと頭を上げ、耳がわずかにぴくぴく動き、琥珀色の目がカメラをまっすぐに見つめ、口がはっきりと動いて滑らかで皮肉な声で話す:「事件は冷え切っていた、冬の魚よりも冷たく。しかし、どんな鶏にも秘密はある。そして私は、その秘密を見つけ出すつもりだった」。",
            "video_url": "https://dashscope-result-sh.oss-accelerate.aliyuncs.com/xxx.mp4?Expires=xxx"
        },
        "usage": {
            "duration": 10,
            "size": "1280*720",
            "input_video_duration": 0,
            "output_video_duration": 10,
            "video_count": 1,
            "SR": 720
        }
    }
outputobjectタスクの出力。

プロパティ

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

列挙値

  • PENDING
  • RUNNING
  • SUCCEEDED
  • FAILED
  • CANCELED
  • UNKNOWN:タスクが存在しないか、ステータスが不明です。
ポーリング中の状態遷移:
  • PENDING → RUNNING → SUCCEEDED または FAILED。
  • 初期クエリのステータスは通常 PENDING または RUNNING です。
  • ステータスが SUCCEEDED に変わると、レスポンスには生成されたビデオの URL が含まれます。
  • ステータスが FAILED の場合は、エラーメッセージを確認してタスクをリトライしてください。
submit_time stringタスクが送信された時刻。時刻は UTC+8 で、フォーマットは YYYY-MM-DD HH:mm:ss.SSS です。scheduled_time stringタスクが実行された時刻。時刻は UTC+8 で、フォーマットは YYYY-MM-DD HH:mm:ss.SSS です。end_time stringタスクが完了した時刻。時刻は UTC+8 で、フォーマットは YYYY-MM-DD HH:mm:ss.SSS です。video_url string生成されたビデオの URL。task_status が SUCCEEDED の場合にのみ返されます。24 時間有効です。ビデオは H.264 エンコーディングの MP4 フォーマットです。orig_prompt string元の入力プロンプト。リクエストパラメーター prompt に対応します。actual_prompt stringprompt_extend=true の場合、システムは入力プロンプトを書き換えます。このフィールドには、生成に使用された書き換え後のプロンプトが含まれます。
  • prompt_extend=false の場合は返されません。
  • wan2.6 モデルは、prompt_extend の値に関係なく、このフィールドを返しません。
code stringエラーコード。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。message string詳細なエラーメッセージ。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。
usage object出力統計。成功したタスクに対してのみ返されます。

プロパティ

video_duration integerwan2.5 以前でのみ返されます (課金に使用)。出力ビデオの持続時間 (秒)。有効な値:5, 10。duration floatwan2.6 でのみ返されます (課金に使用)。総ビデオ持続時間。式:duration=input_video_duration+output_video_duration。input_video_duration integerwan2.6 でのみ返されます。固定値:0。output_video_duration integerwan2.6 でのみ返されます。出力ビデオの持続時間 (秒)。input.duration の値と一致します。SR integerwan2.6 でのみ返されます。出力ビデオの解像度レベル。例:720。size stringwan2.6 でのみ返されます。出力解像度を「幅×高さ」形式で指定します。例:1920×1080。video_ratio stringwan2.5 以前でのみ返されます。出力解像度を「幅×高さ」形式で指定します。例:832×480。video_count integer生成されたビデオの数。常に 1 です。
request_id stringトレースとトラブルシューティングのための一意のリクエスト識別子。

DashScope SDK

SDK のパラメーター名は、ほとんどが HTTP API と一致しており、構造は言語固有の規則に従います。 テキスト動画生成タスクには 1~5 分かかります。SDK は非同期 HTTP 呼び出しフローをラップし、同期および非同期の両方の呼び出しをサポートします。
実際の処理時間は、キューの深さとサービスの負荷によって異なります。

Python SDK

  • SDK は wan2.6 以前をサポートしています。wan2.7 はサポートされていません。
  • DashScope Python SDK バージョン 2.0.1 以降が必要です。
モデルが属するリージョンに基づいて region を設定します(Client の構築時に渡します。region の値はリージョンによって異なります):
  • 北京
  • シンガポール
  • バージニア
region="cn-beijing"
{WorkspaceId} を実際のワークスペース ID に置き換えてください。
  • 同期呼び出し
  • 非同期呼び出し
リクエスト例
import dashscope
import os
from dashscope.v2 import DashScopeError

# 以下の設定はシンガポールリージョン用です。{WorkspaceId} を実際のワークスペース ID に置き換えてください。region の値はリージョンによって異なります。各リージョンのエンドポイントについては、https://www.alibabacloud.com/help/ja/model-studio/text-to-video-api-reference をご参照ください。
client = dashscope.Client(
    # 環境変数が設定されていない場合は、次の行を Model Studio API キーに直接置き換えてください: api_key="sk-xxx"
    # API キーはリージョンによって異なります。API キーの取得: https://www.alibabacloud.com/help/model-studio/get-api-key
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    workspace="{WorkspaceId}",
    region="ap-southeast-1",
)

def sample_sync_call_t2v():
    # generate はワンステップ呼び出し(タスクを送信して完了を待機)で、完了済みの Job を返します
    print('お待ちください...')
    try:
        # audio_url / negative_prompt は input セクションのフィールドで、名前付きシグネチャに含まれないため、extra_input 経由で渡します
        job = client.videos.generate(model='wan2.6-t2v',
                                     prompt="ローアングルからのショット、ミディアムクローズアップ、暖かいトーン、混合照明 (デスクランプからの実用的な光が窓からの曇り空の光と混ざり合う)、サイドライティング、中央構図。クラシックな探偵事務所で、木製の本棚には古い事件ファイルと灰皿が詰まっている。緑のデスクランプが机の中央に広げられた事件ファイルを照らしている。濃い茶色のトレンチコートと薄い灰色のフェドーラ帽をかぶったキツネが革椅子に座り、その毛皮は深紅色で、尾は軽く端に置かれ、指はゆっくりと黄ばんだページをめくっている。外では、青い空の下で絶え間ない霧雨が降り、ガラスに曲がりくねった筋を残している。彼はゆっくりと頭を上げ、耳がわずかにぴくぴく動き、琥珀色の目がカメラをまっすぐに見つめ、口がはっきりと動いて滑らかで皮肉な声で話す:「事件は冷え切っていた、冬の魚よりも冷たく。しかし、どんな鶏にも秘密はある。そして私は、その秘密を見つけ出すつもりだった」。",
                                     extra_input={'audio_url': 'https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250929/stjqnq/%E7%8B%90%E7%8B%B8.mp3',
                                                  'negative_prompt': ""},
                                     size='1280*720',
                                     duration=10,
                                     prompt_extend=True,
                                     watermark=False,
                                     seed=12345)
        print(job)
        print(job.video_url)
    except DashScopeError as e:
        print(f"HTTP status code: {e.status_code}")
        print(f"Error code: {e.code}")
        print(f"Error message: {e.message}")
        print("See the documentation: https://www.alibabacloud.com/help/ja/model-studio/developer-reference/error-code")

if __name__ == '__main__':
    sample_sync_call_t2v()
レスポンス例
video_url は 24 時間後に有効期限が切れます。速やかにダウンロードしてください。
{
    "status_code": 200,
    "request_id": "167f3beb-3dd0-47fe-a83c-xxxxxx",
    "code": null,
    "message": "",
    "output": {
        "task_id": "5b65411f-d946-4e29-859e-xxxxxx",
        "task_status": "SUCCEEDED",
        "video_url": "https://dashscope-result-bj.oss-accelerate.aliyuncs.com/xxx.mp4?Expires=xxx",
        "submit_time": "2025-10-23 11:47:23.879",
        "scheduled_time": "2025-10-23 11:47:34.351",
        "end_time": "2025-10-23 11:52:35.323",
        "orig_prompt": "ローアングルからのショット、ミディアムクローズアップ、暖かいトーン、混合照明 (デスクランプからの実用的な光が窓からの曇り空の光と混ざり合う)、サイドライティング、中央構図。クラシックな探偵事務所で、木製の本棚には古い事件ファイルと灰皿が詰まっている。緑のデスクランプが机の中央に広げられた事件ファイルを照らしている。濃い茶色のトレンチコートと薄い灰色のフェドーラ帽をかぶったキツネが革椅子に座り、その毛皮は深紅色で、尾は軽く端に置かれ、指はゆっくりと黄ばんだページをめくっている。外では、青い空の下で絶え間ない霧雨が降り、ガラスに曲がりくねった筋を残している。彼はゆっくりと頭を上げ、耳がわずかにぴくぴく動き、琥珀色の目がカメラをまっすぐに見つめ、口がはっきりと動いて滑らかで皮肉な声で話す:「事件は冷え切っていた、冬の魚よりも冷たく。しかし、どんな鶏にも秘密はある。そして私は、その秘密を見つけ出すつもりだった」。"
    },
    "usage": {
        "video_count": 1,
        "video_duration": 0,
        "video_ratio": "",
        "duration": 10,
        "size": "1280*720",
        "input_video_duration": 0,
        "output_video_duration": 10,
        "SR": 720
    }
}

Java SDK

  • SDK は wan2.6 以前をサポートしています。wan2.7 はサポートされていません。
  • DashScope Java SDK バージョン 2.22.6 以降が必要です。 古いバージョンでは「url error, please check url!」が返されることがあります。更新するには、「SDK のインストール」をご参照ください。
Constants.baseHttpApiUrl をリージョンエンドポイントに設定します:
  • シンガポール
  • バージニア
  • 北京
Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
{WorkspaceId} を実際のワークスペース ID に置き換えてください。
  • 同期呼び出し
  • 非同期呼び出し
リクエスト例
// Copyright (c) Alibaba, Inc. and its affiliates.

// dashscope SDK バージョン 2.18.2 以降
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesis;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisParam;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisResult;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.utils.JsonUtils;
import com.alibaba.dashscope.utils.Constants;

import java.util.HashMap;
import java.util.Map;

public class Text2Video {

    static {
        // シンガポールリージョンの URL。URL はリージョンによって異なります。詳細については、https://www.alibabacloud.com/help/ja/model-studio/text-to-video-api-reference をご参照ください。
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
    }

    // 環境変数が設定されていない場合は、値を Model Studio API キーに置き換えてください:apiKey = "sk-xxx"。
    // API キーはリージョンによって異なります。詳細については、https://www.alibabacloud.com/help/ja/model-studio/get-api-key をご参照ください。
    public static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    public static void text2Video() throws ApiException, NoApiKeyException, InputRequiredException {
        VideoSynthesis vs = new VideoSynthesis();
        Map<String, Object> parameters = new HashMap<>();
        parameters.put("prompt_extend", true);
        parameters.put("watermark", false);
        parameters.put("seed", 12345);

        VideoSynthesisParam param =
                VideoSynthesisParam.builder()
                        .apiKey(apiKey)
                        .model("wan2.6-t2v")
                        .prompt("ローアングルからのショット、ミディアムクローズアップ、暖かいトーン、混合照明 (デスクランプからの実用的な光が窓からの曇り空の光と混ざり合う)、サイドライティング、中央構図。クラシックな探偵事務所で、木製の本棚には古い事件ファイルと灰皿が詰まっている。緑のデスクランプが机の中央に広げられた事件ファイルを照らしている。濃い茶色のトレンチコートと薄い灰色のフェドーラ帽をかぶったキツネが革椅子に座り、その毛皮は深紅色で、尾は軽く端に置かれ、指はゆっくりと黄ばんだページをめくっている。外では、青い空の下で絶え間ない霧雨が降り、ガラスに曲がりくねった筋を残している。彼はゆっくりと頭を上げ、耳がわずかにぴくぴく動き、琥珀色の目がカメラをまっすぐに見つめ、口がはっきりと動いて滑らかで皮肉な声で話す:「事件は冷え切っていた、冬の魚よりも冷たく。しかし、どんな鶏にも秘密はある。そして私は、その秘密を見つけ出すつもりだった」。")
                        .audioUrl("https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250929/stjqnq/%E7%8B%90%E7%8B%B8.mp3")
                        .negativePrompt("")
                        .size("1280*720")
                        .duration(10)
                        .parameters(parameters)
                        .build();
        System.out.println("お待ちください...");
        VideoSynthesisResult result = vs.call(param);
        System.out.println(JsonUtils.toJson(result));
    }

    public static void main(String[] args) {
        try {
            text2Video();
        } catch (ApiException | NoApiKeyException | InputRequiredException e) {
            System.out.println(e.getMessage());
        }
        System.exit(0);
    }
}
レスポンス例
video_url は 24 時間後に有効期限が切れます。速やかにダウンロードしてください。
{
    "request_id": "c1209113-8437-424f-a386-xxxxxx",
    "output": {
        "task_id": "966cebcd-dedc-4962-af88-xxxxxx",
        "task_status": "SUCCEEDED",
        "video_url": "https://dashscope-result-sh.oss-accelerate.aliyuncs.com/xxx.mp4?Expires=xxx",
        "orig_prompt": "ローアングルからのショット、ミディアムクローズアップ、暖かいトーン、混合照明 (デスクランプからの実用的な光が窓からの曇り空の光と混ざり合う)、サイドライティング、中央構図。クラシックな探偵事務所で、木製の本棚には古い事件ファイルと灰皿が詰まっている。緑のデスクランプが机の中央に広げられた事件ファイルを照らしている。濃い茶色のトレンチコートと薄い灰色のフェドーラ帽をかぶったキツネが革椅子に座り、その毛皮は深紅色で、尾は軽く端に置かれ、指はゆっくりと黄ばんだページをめくっている。外では、青い空の下で絶え間ない霧雨が降り、ガラスに曲がりくねった筋を残している。彼はゆっくりと頭を上げ、耳がわずかにぴくぴく動き、琥珀色の目がカメラをまっすぐに見つめ、口がはっきりと動いて滑らかで皮肉な声で話す:「事件は冷え切っていた、冬の魚よりも冷たく。しかし、どんな鶏にも秘密はある。そして私は、その秘密を見つけ出すつもりだった」。",
        "submit_time": "2026-01-22 23:13:40.553",
        "scheduled_time": "2026-01-22 23:13:49.415",
        "end_time": "2026-01-22 23:17:56.380"
    },
    "usage": {
        "video_count": 1,
        "duration": 10.0,
        "size": "1280*720",
        "input_video_duration": 0.0,
        "output_video_duration": 10.0,
        "SR": "720"
    },
    "status_code": 200,
    "code": "",
    "message": ""
}

制限事項

  • データ保持:タスク ID (task_id) とビデオ URL (video_url) は 24 時間後に有効期限が切れます。有効期限が切れると、クエリやダウンロードはできなくなります。
  • コンテンツモデレーション:入力と出力はコンテンツモデレーションの対象となります。禁止されたコンテンツは「IPInfringementSuspect」または「DataInspectionFailed」エラーをトリガーします。「エラーコード」をご参照ください。

エラーコード

モデルの呼び出しが失敗し、エラーメッセージが返された場合は、「エラーコード」で解決策をご確認ください。

よくある質問

Q:wan2.6 から wan2.7 にアップグレードするために必要なコードの変更点は何ですか?

A:2 つの変更が必要です:
  • 解像度制御:wan2.7 は size フィールドを置き換えます。代わりに、resolution (解像度レベル) と ratio (アスペクト比) の組み合わせを使用して出力解像度を定義します。以前のモデルでは size フィールドが使用されていました。
  • ショットタイプの削除:wan2.7 は shot_type フィールドを廃止しました。代わりに、プロンプトで直接ショット構造を記述します。

Q:一時的なビデオリンクを永続的なものに変換するにはどうすればよいですか?

A:直接の変換はできません。URL からビデオをダウンロードし、それを永続ストレージ (Alibaba Cloud OSS など) にアップロードして永続的なリンクを生成してください。
import requests

def download_and_save_video(video_url, save_path):
    try:
        response = requests.get(video_url, stream=True, timeout=300)
        response.raise_for_status()
        with open(save_path, 'wb') as f:
            for chunk in response.iter_content(chunk_size=8192):
                f.write(chunk)
        print(f"ビデオが正常にダウンロードされました: {save_path}")
        # ここにビデオを永続ストレージにアップロードするロジックを追加できます
    except requests.exceptions.RequestException as e:
        print(f"ビデオのダウンロードに失敗しました: {e}")

if __name__ == '__main__':
    video_url = "http://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxxx"
    save_path = "video.mp4"
    download_and_save_video(video_url, save_path)

Q:返されたビデオリンクはブラウザで直接再生できますか?

A:いいえ。リンクは 24 時間後に有効期限が切れます。ビデオをダウンロードし、永続的に保存して、再生には永続的なリンクを使用してください。