DashScope SDK を使用した Wan API による AI 動画生成 - Model Studio

Wan テキストから動画へモデルは、テキストプロンプトに基づいて滑らかな動画を生成します。

関連ドキュメント: ユーザーガイド

可用性

API 呼び出しが正常に実行されるためには、モデル、エンドポイント URL、および API キーが同一のリージョンに属している必要があります。クロスリージョンでの呼び出しは失敗します。

モデルの選択: 対象リージョンで該当モデルが利用可能であることを確認します。
URL の選択: 対応するリージョン固有のエンドポイント URL を選択します。HTTP および HTTPS の両方がサポートされます。
API キーの設定: リージョンを選択し、API キーを取得して、環境変数に設定します。
SDK のインストール: SDK を使用して API を呼び出す場合、DashScope SDK をインストールします。

説明

このトピック内のサンプルコードは、シンガポール リージョン向けです。

HTTP

テキストから動画へタスクは処理に時間がかかる（通常 1～5 分）ため、API では非同期呼び出し方式を採用しており、「タスク作成 → 結果のポーリング」という 2 ステップで構成されます。

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

シンガポール

POST https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis

米国 (バージニア)

POST https://dashscope-us.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis

北京

POST https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis

説明

タスク作成後は、返された task_id を使用して結果を照会します。task_id の有効期限は 24 時間です。重複したタスクを作成しないでください。代わりに、ポーリングにより結果を取得してください。
初心者向けチュートリアルについては、Postman をご参照ください。

リクエストパラメーター	マルチショットナラティブこの機能は wan2.6 シリーズのモデルのみでサポートされています。この機能を有効にするには、`"prompt_extend": true` および `"shot_type":"multi"` を設定します。 curl --location 'https://dashscope-intl.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/fox.mp3" }, "parameters": { "size": "1280720", "prompt_extend": true, "duration": 10, "shot_type":"multi" } }' 自動ダブリングこの機能は wan2.6 および wan2.5 シリーズのモデルのみでサポートされています。 `input.audio_url` を指定しない場合、モデルは動画コンテンツに基づいて、適切なバックグラウンド音楽または効果音を自動生成します。 curl --location 'https://dashscope-intl.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.5-t2v-preview", "input": { "prompt": "ローアングル、中距離クローズアップ、暖色調、混合照明（デスクランプの実用光と窓からの曇天光が混ざり合う）、サイドライティング、中央構図。クラシックな探偵事務所で、木製の本棚には古びた事件ファイルと灰皿が並んでいます。緑色のデスクランプが、デスク中央に広げられた事件ファイルを照らしています。茶色のトレンチコートと薄灰色のフェドラ帽を着用した赤毛のキツネが革張りの椅子に座り、しっぽを端に軽く乗せ、黄色くなったページをゆっくりとめくっています。外には青空の下、じっとりとした小雨が降っており、ガラスにうねるような筋が走っています。キツネはゆっくりと頭を上げ、耳をわずかに震わせ、琥珀色の目でカメラをじっと見つめ、滑らかで皮肉な声でこう話しています。「この事件は冷めていた。冬の魚よりも冷めていた。だが、すべてのニワトリには秘密がある。そして私は、その秘密を明らかにするつもりだ。」" }, "parameters": { "size": "832480", "prompt_extend": true, "duration": 10 } }' 音声ファイルの提供この機能は wan2.6 および wan2.5 シリーズのモデルのみでサポートされています。 `input.audio_url` パラメーターを使用して、カスタム音声ファイルの URL を指定できます。 curl --location 'https://dashscope-intl.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.5-t2v-preview", "input": { "prompt": "ローアングル、中距離クローズアップ、暖色調、混合照明（デスクランプの実用光と窓からの曇天光が混ざり合う）、サイドライティング、中央構図。クラシックな探偵事務所で、木製の本棚には古びた事件ファイルと灰皿が並んでいます。緑色のデスクランプが、デスク中央に広げられた事件ファイルを照らしています。茶色のトレンチコートと薄灰色のフェドラ帽を着用した赤毛のキツネが革張りの椅子に座り、しっぽを端に軽く乗せ、黄色くなったページをゆっくりとめくっています。外には青空の下、じっとりとした小雨が降っており、ガラスにうねるような筋が走っています。キツネはゆっくりと頭を上げ、耳をわずかに震わせ、琥珀色の目でカメラをじっと見つめ、滑らかで皮肉な声でこう話しています。「この事件は冷めていた。冬の魚よりも冷めていた。だが、すべてのニワトリには秘密がある。そして私は、その秘密を明らかにするつもりだ。」", "audio_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250929/stjqnq/fox.mp3" }, "parameters": { "size": "832480", "prompt_extend": true, "duration": 10 } }' 無音動画の生成無音動画の生成は、wan2.2 および wan2.1 シリーズのモデルのみでサポートされています。無音動画はデフォルトで生成されるため、特別な設定は不要です。 wan2.6 および wan2.5 シリーズのモデルでは、デフォルトで音声付き動画が生成されます。 curl --location 'https://dashscope-intl.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.2-t2v-plus", "input": { "prompt": "低コントラスト、レトロな 70 年代風地下鉄駅。薄暗い色合いと粗い質感の中で、路上ミュージシャンが演奏しています。古いスタイルのジャケットを着てギターを抱え、集中して演奏しています。通勤客が急ぎ足で通り過ぎ、少しずつ小さな聴衆が集まり始めています。カメラは右方向にゆっくりパンし、楽器の音が街の喧騒と交じり合うシーンを捉えます。背景にはレトロな地下鉄の標識と斑点模様の壁があります。" }, "parameters": { "size": "832480", "prompt_extend": true } }' ネガティブプロンプトの使用 negative_prompt を使用して、「花」要素を除外し、動画内に出現しないようにします。 `curl --location 'https://dashscope-intl.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.2-t2v-plus", "input": { "prompt": "月明かりの下を走る子猫", "negative_prompt": "flower" }, "parameters": { "size": "832*480" } }'`
ヘッダー
Content-Type `文字列` （必須）リクエストのコンテンツタイプです。値は `application/json` である必要があります。
Authorization `文字列` (必須) Model Studio API キーを使用した認証情報です。例： `Bearer sk-xxxx`
X-DashScope-Async `文字列` （必須）非同期処理を有効化します。HTTP リクエストは非同期処理のみをサポートするため、値は必ず `enable` とする必要があります。重要このヘッダーが含まれていない場合、「current user api does not support synchronous calls」エラーが返されます。
リクエスト本文
model `文字列` (必須) モデル名です。モデルおよび価格のリストについては、「モデル価格」をご参照ください。例： wan2.6-t2v
input `オブジェクト` （必須）プロンプトを含む基本的な入力情報です。プロパティ prompt `文字列` （必須）生成される動画の望ましいコンテンツおよび視覚的特徴を記述するテキストプロンプトです。中国語および英語の両方をサポートします。中国語の1文字または英字1文字を1文字としてカウントします。文字数制限を超えた部分は自動的に切り捨てられます。文字数制限はモデルバージョンによって異なります： wan2.6 および wan2.5 シリーズのモデル：最大 1,500 文字。 wan2.2 および wan2.1 シリーズのモデル：最大 800 文字。例：月明かりの下で走る子猫。ヒントについては、「テキストから動画へ／イメージから動画へ：プロンプトガイド」をご参照ください。 negative_prompt `文字列` （任意）動画から除外したいコンテンツを記述するネガティブプロンプトです。出力内容を制約するのに役立ちます。中国語および英語の両方をサポートします。文字数は最大 500 文字までです。文字数制限を超えた部分は自動的に切り捨てられます。例：解像度が低い、エラー、最悪の品質、低品質、変形、余分な指、不自然な比率。 audio_url `文字列` （任意）対応モデル：wan2.6 および wan2.5。音声ファイルの URL です。この音声に合わせて動画の生成が同期されます。対応する入力フォーマットは以下のとおりです：公開 URL： HTTP および HTTPS プロトコルをサポートします。例：https://help-static-aliyun-doc.aliyuncs.com/xxx.mp3。音声の制限事項：フォーマット：WAV、MP3。再生時間：3～30 秒。ファイルサイズ：最大 15 MB。制限超過時の処理：音声の再生時間が `duration` 値（例：5 秒）を超える場合、先頭 5 秒のみが使用され、残りは破棄されます。また、音声の再生時間が動画の再生時間より短い場合は、動画の残りの部分は無音になります。たとえば、音声が 3 秒、動画の再生時間が 5 秒の場合、出力動画の最初の 3 秒は音声付きとなり、最後の 2 秒は無音となります。
パラメーター `オブジェクト`（任意）動画処理のパラメーター。解像度、プロンプト再書き込み、ウォーターマークの付与を含みます。プロパティ size `文字列`（任意）重要 `size` パラメーターはコストに直接影響します。コスト＝解像度に基づく単価 × 処理時間（秒）。同一モデルにおいて、1080P ＞ 720P ＞ 480P です。API を呼び出す前に、「モデルの課金情報」をご参照ください。 `size` には、`1:1` や `480P` のような比率または階層ではなく、``1280720`` のような具体的な値を指定する必要があります。生成される動画の解像度を ``幅高さ`` のフォーマットで指定します。このパラメーターのデフォルト値および利用可能な列挙値は、`model` パラメーターに依存し、以下のとおりです： wan2.6-t2v：デフォルト値は ``19201080``（1080P）。選択可能な解像度：720P および 1080P に対応するすべての解像度。 wan2.6-t2v-us：デフォルト値は ``19201080``（1080P）。利用可能な解像度：720P および 1080P に対応するすべての解像度。 wan2.5-t2v-preview：デフォルト値は ``19201080``（1080P）。選択可能な解像度：480P、720P、および 1080P に対応するすべての解像度。 wan2.2-t2v-plus：デフォルト値は ``19201080``（1080P）。選択可能な解像度：480P および 1080P に対応するすべての解像度。 wan2.1-t2v-turbo：デフォルト値は ``1280720``（720P）。選択可能な解像度：480P および 720P に対応するすべての解像度。 wan2.1-t2v-plus：デフォルト値は ``1280720``（720P）。選択可能な解像度：720P に対応するすべての解像度。 480P 階層：選択可能な動画解像度および対応する縦横比は以下のとおりです。 `832480`：16:9。 `480832`：9:16。 `624624`：1:1。 720P 階層：選択可能な動画解像度および対応する縦横比は以下のとおりです。 `1280720`：16:9。 `7201280`：9:16。 `960960`：1:1。 `1088832`：4:3。 `8321088`：3:4。 1080P 階層：選択可能な動画解像度および対応する縦横比は以下のとおりです。 `19201080`：16:9。 `10801920`：9:16。 `14401440`：1:1。 `16321248`：4:3。 `12481632`：3:4。 duration* `整数`（任意）重要 `duration` パラメーターはコストに直接影響します。コスト＝解像度に基づく単価 × 処理時間（秒）。API を呼び出す前に、「モデルの課金情報」をご参照ください。生成される動画の長さ（秒単位）。このパラメーターの値は、`model` パラメーターに依存します： 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 秒（変更不可）。例：5。 prompt_extend `ブール値`（任意）。デフォルト値は `true`。プロンプト再書き込みを有効にするかどうか。有効にすると、LLM が入力プロンプトを再書き込みします。短いプロンプトの場合、生成品質が大幅に向上しますが、処理時間も延長されます。 true false 例：`true` shot_type `文字列`（任意）対応モデル：wan2.6 シリーズのモデル。生成される動画のショットタイプ（単一連続ショットか、複数の切り替わりショットか）を指定します。効果が適用される条件：このパラメーターは、``"prompt_extend": true`` の場合のみ有効です。パラメーターの優先順位：``shot_type > prompt``。たとえば、`shot_type` を `"single"` に設定した場合、プロンプトに「マルチショット動画を生成」と記述されていても、モデルは単一ショットの動画を出力します。選択可能な値： single（デフォルト） multi 例：single。説明動画のナラティブ構造を厳密に制御する必要がある場合に使用します。たとえば、製品紹介には単一ショット、短編ストーリーには複数ショットを用いるなどです。 watermark `ブール値`（任意）ウォーターマークを付与するかどうかを指定します。ウォーターマークは動画の右下隅に固定位置で表示され、「AI Generated」というテキストが含まれます。 false（デフォルト） true 例：false。 seed `整数`（任意）乱数シード。``0`` から ``2147483647`` の範囲の整数である必要があります。指定しない場合、ランダムなシードが自動生成されます。固定のシードを使用すると再現性が向上しますが、モデル固有のランダム性により結果が若干異なる場合があります。例：`12345`

応答パラメーター	成功応答 `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 `オブジェクト` タスク出力情報。プロパティ task_id `文字列` タスクのID。タスクを最大24時間照会するために使用できます。 task_status `文字列` タスクのステータス。列挙 PENDING RUNNING SUCCEEDED FAILED CANCELED UNKNOWN: タスクが存在しないか、ステータスが不明です
request_id `文字列` リクエストの一意の識別子。問題の追跡とトラブルシューティングに使用します。
code `文字列` エラーコード。リクエストが失敗した場合にのみ返されます。詳細については、「エラーコード」をご参照ください。
message `文字列` 詳細なエラーメッセージ。リクエストが失敗した場合にのみ返されます。詳細については、「エラーコード」をご参照ください。

ステップ 2：結果のクエリ

シンガポール

GET https://dashscope-intl.aliyuncs.com/api/v1/tasks/{task_id}

米国 (バージニア)

GET https://dashscope-us.aliyuncs.com/api/v1/tasks/{task_id}

北京

GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}

説明

ポーリングの推奨設定：動画生成には数分かかる場合があります。合理的なクエリ間隔（例：15 秒）でポーリングメカニズムを使用することを推奨します。
タスクステータスのトランジション：PENDING → RUNNING → SUCCEEDED または FAILED。
結果 URL：タスクが成功すると、動画の URL が返されます。この URL の有効期間は 24 時間 です。URL を取得したら、ただちに動画をダウンロードし、Object Storage Service (OSS) などの永続ストレージサービスに保存してください。
task_id の有効期間：24 時間。この期間を過ぎると結果をクエリできなくなり、API はタスクステータスとして UNKNOWN を返します。

リクエストパラメーター	タスク結果のクエリ `{task_id}` は、直前の API 呼び出しで返された `task_id` の値に置き換えてください。 `curl -X GET https://dashscope-intl.aliyuncs.com/api/v1/tasks/{task_id} \ --header "Authorization: Bearer $DASHSCOPE_API_KEY"`
ヘッダー
Authorization `文字列` (必須) Model Studio API キーを使用した認証情報です。例： `Bearer sk-xxxx`
パスパラメーター
task_id `文字列` (必須) クエリ対象のタスク 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": "Shot from a low angle, in a medium close-up, with warm tones, mixed lighting (the practical light from the desk lamp blends with the overcast light from the window), side lighting, and a central composition. In a classic detective's office, wooden bookshelves are filled with old case files and ashtrays. A green desk lamp illuminates a case file spread out in the center of the desk. A fox, wearing a dark brown trench coat and a light gray fedora, sits in a leather chair, its fur crimson, its tail resting lightly on the edge, its fingers slowly turning yellowed pages. Outside, a steady drizzle falls beneath a blue sky, streaking the glass with meandering streaks. It slowly raises its head, its ears twitching slightly, its amber eyes gazing directly at the camera, its mouth clearly moving as it speaks in a smooth, cynical voice: 'The case was cold, colder than a fish in winter. But every chicken has its secrets, and I, for one, intended to find them '. ", "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 } } タスク実行失敗時タスクが失敗すると、`task_status` は FAILED に設定され、エラーコードとエラーメッセージが返されます。問題を解決するには、「エラーコード」をご参照ください。 `{ "request_id": "e5d70b02-ebd3-98ce-9fe8-759d7d7b107d", "output": { "task_id": "86ecf553-d340-4e21-af6e-a0c6a421c010", "task_status": "FAILED", "code": "InvalidParameter", "message": "The size is not match xxxxxx" } }` タスククエリ期限切れ時 `task_id` の有効期間は 24 時間です。この期間を過ぎるとクエリは失敗し、以下のエラーメッセージが返されます。 `{ "request_id": "a4de7c32-7057-9f82-8581-xxxxxx", "output": { "task_id": "502a00b1-19d9-4839-a82f-xxxxxx", "task_status": "UNKNOWN" } }`
output `オブジェクト` タスクの出力情報です。プロパティ task_id `文字列` タスクの ID です。最大 24 時間までタスクのクエリに使用できます。 task_status `文字列` タスクのステータスです。列挙値 PENDING RUNNING SUCCEEDED FAILED CANCELED UNKNOWN：タスクが存在しない、またはステータス不明ポーリング時のステータストランジション： PENDING → RUNNING → SUCCEEDED または FAILED 初回クエリでは通常 PENDING または RUNNING が返されます SUCCEEDED ステータスの場合、応答に生成された動画の URL が含まれます FAILED ステータスの場合、エラーメッセージを確認して再試行してください submit_time `文字列` タスクの送信時刻です。時刻は UTC + 08:00 です。フォーマット： `YYYY-MM-DD HH:mm:ss.SSS`。 scheduled_time `文字列` タスクの実行開始時刻です。時刻は UTC + 08:00 です。フォーマット： `YYYY-MM-DD HH:mm:ss.SSS`。 end_time `文字列` タスクの完了時刻です。時刻は UTC + 08:00 です。フォーマット： `YYYY-MM-DD HH:mm:ss.SSS`。 video_url `文字列` 生成された動画の URL です。`task_status` が SUCCEEDED の場合にのみ返されます。 URL の有効期間は 24 時間です。H.264 エンコーディングで MP4 形式の動画をダウンロードするために使用します。 orig_prompt `文字列` 元の入力プロンプトです。これは `prompt` リクエストパラメーターの値です。 actual_prompt `文字列` `prompt_extend=true` の場合、システムは入力プロンプトに対してプロンプトリライトを行います。このフィールドは、実際に生成に使用された最適化済みプロンプトを返します。 `prompt_extend=false` の場合、このフィールドは返されません。注：wan2.6 モデルは、`prompt_extend` の値に関係なく、このフィールドを返しません。 code `文字列` エラーコードです。リクエストが失敗した場合にのみ返されます。詳細については、「エラーコード」をご参照ください。 message `文字列` 詳細なエラーメッセージです。リクエストが失敗した場合にのみ返されます。詳細については、「エラーコード」をご参照ください。
usage `オブジェクト` 出力に関する統計情報です。成功した結果のみがカウントされます。プロパティ video_duration `整数` wan2.5 以前のモデルを使用している場合にのみ返されます。課金に使用されます。生成された動画の長さ（秒単位）です。列挙値は 5 および 10 です。 duration `浮動小数点数` wan2.6 モデルを使用している場合にのみ返されます。課金に使用されます。合計動画長を示します。`duration=input_video_duration+output_video_duration` です。 input_video_duration `整数` wan2.6 モデルを使用している場合にのみ返されます。値は固定で 0 です。 output_video_duration `整数` wan2.6 モデルを使用している場合に返されます。出力動画の長さ（秒単位）です。`input.duration` の値と同じになります。 SR `整数` wan2.6 モデルを使用している場合に返されます。生成された動画の解像度階層です。例：720。 size `文字列` wan2.6 モデルを使用する場合にのみ返されます。生成された動画の解像度です。フォーマットは「幅高さ」です。例: 19201080。 video_ratio `文字列` wan2.5 以前のモデルを使用する場合にのみ返されます。生成された動画の解像度です。フォーマットは「幅高さ」です。例: 832480。 video_count `整数` 生成された動画の数です。値は固定で 1 です。
request_id `文字列` リクエストの一意な識別子です。トレースおよび問題のトラブルシューティングに使用します。

DashScope SDK

SDK のパラメーター名は、HTTP API とほぼ一致します。パラメーターの構造は、言語固有の規則に従います。

テキストから動画へタスクは処理に時間がかかる（通常 1～5 分）ため、SDK は非同期 HTTP 呼び出しフローをラップしており、同期および非同期呼び出しの両方をサポートします。

実際の所要時間は、キュー内のタスク数およびサービスの実行状況に依存します。

Python SDK

重要

以下のコードを実行する前に、DashScope Python SDK のバージョンが 最低でも 1.25.8 であることを確認してください。

古いバージョンを使用すると、「url error, please check url!」などのエラーが発生する可能性があります。SDK を更新するには、「SDK のインストール」をご参照ください。

モデルの所在リージョンに応じて、base_http_api_url を設定します。

同期呼び出し

リクエスト例

from http import HTTPStatus
from dashscope import VideoSynthesis
import dashscope
import os

# 以下はシンガポールリージョン向けの URL です。リージョンごとに URL が異なります。URL の取得方法: https://www.alibabacloud.com/help/en/model-studio/text-to-video-api-reference
dashscope.base_http_api_url = 'https://dashscope-intl.aliyuncs.com/api/v1'

# 環境変数を設定していない場合は、次の行を Model Studio API キーに置き換えてください: api_key="sk-xxx"
# リージョンごとに API キーが異なります。API キーの取得方法: https://www.alibabacloud.com/help/en/model-studio/get-api-key
api_key = os.getenv("DASHSCOPE_API_KEY")

def sample_sync_call_t2v():
    # 同期 API を呼び出します。結果が返されます。
    print('しばらくお待ちください...')
    rsp = VideoSynthesis.call(api_key=api_key,
                              model='wan2.6-t2v',
                              prompt="ローアングル、中距離クローズアップ、暖色調、混合照明（デスクランプの実用光と窓からの曇天光が混ざり合う）、サイドライティング、中央構図。クラシックな探偵事務所で、木製の本棚には古びた事件ファイルと灰皿が並んでいます。緑色のデスクランプが、デスク中央に広げられた事件ファイルを照らしています。茶色のトレンチコートと薄灰色のフェドラ帽を着用した赤毛のキツネが革張りの椅子に座り、しっぽを端に軽く乗せ、黄色くなったページをゆっくりとめくっています。外には青空の下、じっとりとした小雨が降っており、ガラスにうねるような筋が走っています。キツネはゆっくりと頭を上げ、耳をわずかに震わせ、琥珀色の目でカメラをじっと見つめ、滑らかで皮肉な声でこう話しています。「この事件は冷めていた。冬の魚よりも冷めていた。だが、すべてのニワトリには秘密がある。そして私は、その秘密を明らかにするつもりだ。」",
                              audio_url='https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250929/stjqnq/fox.mp3',
                              size='1280*720',
                              duration=10,
                              negative_prompt="",
                              prompt_extend=True,
                              watermark=False,
                              seed=12345)
    print(rsp)
    if rsp.status_code == HTTPStatus.OK:
        print(rsp.output.video_url)
    else:
        print('失敗しました。status_code: %s、code: %s、message: %s' %
              (rsp.status_code, rsp.code, rsp.message))


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

非同期呼び出し

リクエスト例

from http import HTTPStatus
from dashscope import VideoSynthesis
import dashscope
import os

# 以下はシンガポールリージョン向けの URL です。リージョンごとに URL が異なります。URL の取得方法: https://www.alibabacloud.com/help/en/model-studio/text-to-video-api-reference
dashscope.base_http_api_url = 'https://dashscope-intl.aliyuncs.com/api/v1'

# 環境変数を設定していない場合は、次の行を Model Studio API キーに置き換えてください: api_key="sk-xxx"
# リージョンごとに API キーが異なります。API キーの取得方法: https://www.alibabacloud.com/help/en/model-studio/get-api-key
api_key = os.getenv("DASHSCOPE_API_KEY")

def sample_async_call_t2v():
    # 非同期 API を呼び出します。タスク情報が返されます。
    # 返されたタスク ID を使用して、タスクのステータスを取得できます。
    rsp = VideoSynthesis.async_call(api_key=api_key,
                                    model='wan2.6-t2v',
                                    prompt="ローアングル、中距離クローズアップ、暖色調、混合照明（デスクランプの実用光と窓からの曇天光が混ざり合う）、サイドライティング、中央構図。クラシックな探偵事務所で、木製の本棚には古びた事件ファイルと灰皿が並んでいます。緑色のデスクランプが、デスク中央に広げられた事件ファイルを照らしています。茶色のトレンチコートと薄灰色のフェドラ帽を着用した赤毛のキツネが革張りの椅子に座り、しっぽを端に軽く乗せ、黄色くなったページをゆっくりとめくっています。外には青空の下、じっとりとした小雨が降っており、ガラスにうねるような筋が走っています。キツネはゆっくりと頭を上げ、耳をわずかに震わせ、琥珀色の目でカメラをじっと見つめ、滑らかで皮肉な声でこう話しています。「この事件は冷めていた。冬の魚よりも冷めていた。だが、すべてのニワトリには秘密がある。そして私は、その秘密を明らかにするつもりだ。」",
                                    audio_url='https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250929/stjqnq/fox.mp3',
                                    size='1280*720',
                                    duration=10,
                                    negative_prompt="",
                                    prompt_extend=True,
                                    watermark=False,
                                    seed=12345)
    print(rsp)
    if rsp.status_code == HTTPStatus.OK:
        print("task_id: %s" % rsp.output.task_id)
    else:
        print('失敗しました。status_code: %s、code: %s、message: %s' %
              (rsp.status_code, rsp.code, rsp.message))
                           
    # タスク情報（タスクステータスを含む）を取得します。
    status = VideoSynthesis.fetch(task=rsp, api_key=api_key)
    if status.status_code == HTTPStatus.OK:
        print(status.output.task_status)  # タスクステータスを確認
    else:
        print('失敗しました。status_code: %s、code: %s、message: %s' %
              (status.status_code, status.code, status.message))

    # タスクの完了を待機します。これは、一定間隔で fetch を呼び出して、タスクが完了状態にあるかを確認します。
    rsp = VideoSynthesis.wait(task=rsp, api_key=api_key)
    print(rsp)
    if rsp.status_code == HTTPStatus.OK:
        print(rsp.output.video_url)
    else:
        print('失敗しました。status_code: %s、code: %s、message: %s' %
              (rsp.status_code, rsp.code, rsp.message))


if __name__ == '__main__':
    sample_async_call_t2v()

レスポンス例

1. タスク作成リクエストに対するレスポンスの例

{
	"status_code": 200,
	"request_id": "c86ff7ba-8377-917a-90ed-xxxxxx",
	"code": "",
	"message": "",
	"output": {
		"task_id": "721164c6-8619-4a35-a6d9-xxxxxx",
		"task_status": "PENDING",
		"video_url": ""
	},
	"usage": null
}

2. タスク照会リクエストに対するレスポンスの例

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

重要

DashScope Java SDK のバージョンが 2.22.6 以降であることを確認してから、以下のコードを実行してください。

モデルの所在リージョンに応じて、baseHttpApiUrl を設定します。

シンガポール

Constants.baseHttpApiUrl = "https://dashscope-intl.aliyuncs.com/api/v1";

米国 (バージニア)

Constants.baseHttpApiUrl = "https://dashscope-us.aliyuncs.com/api/v1";

北京

Constants.baseHttpApiUrl = "https://dashscope.aliyuncs.com/api/v1";

同期呼び出し

リクエスト例

// 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 が異なります。URL の取得方法: https://www.alibabacloud.com/help/en/model-studio/text-to-video-api-reference
         Constants.baseHttpApiUrl="https://dashscope-intl.aliyuncs.com/api/v1";
    }
    
    // 環境変数を設定していない場合は、次の行を Model Studio API キーに置き換えてください: apiKey="sk-xxx"
    // リージョンごとに API キーが異なります。API キーの取得方法: https://www.alibabacloud.com/help/en/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/fox.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": ""
}

非同期呼び出し

リクエスト例

// Copyright (c) Alibaba, Inc. and its affiliates.

import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesis;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisListResult;
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.task.AsyncTaskListParam;
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 が異なります。URL の取得方法: https://www.alibabacloud.com/help/en/model-studio/text-to-video-api-reference
        Constants.baseHttpApiUrl="https://dashscope-intl.aliyuncs.com/api/v1";
    }

     // 環境変数を設定していない場合は、次の行を Model Studio API キーに置き換えてください: apiKey="sk-xxx"
    // リージョンごとに API キーが異なります。API キーの取得方法: https://www.alibabacloud.com/help/en/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("ローアングル、中距離クローズアップ、暖色調、混合照明（デスクランプの実用光と窓からの曇天光が混ざり合う）、サイドライティング、中央構図。クラシックな探偵事務所で、木製の本棚には古びた事件ファイルと灰皿が並んでいます。緑色のデスクランプが、デスク中央に広げられた事件ファイルを照らしています。茶色のトレンチコートと薄灰色のフェドラ帽を着用した赤毛のキツネが革張りの椅子に座り、しっぽを端に軽く乗せ、黄色くなったページをゆっくりとめくっています。外には青空の下、じっとりとした小雨が降っており、ガラスにうねるような筋が走っています。キツ// Copyright (c) Alibaba, Inc. and its affiliates.

import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesis;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisListResult;
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.task.AsyncTaskListParam;
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 が異なります。URL の取得方法: https://www.alibabacloud.com/help/en/model-studio/text-to-video-api-reference
        Constants.baseHttpApiUrl="https://dashscope-intl.aliyuncs.com/api/v1";
    }

     // 環境変数を設定していない場合は、次の行を Model Studio API キーに置き換えてください: apiKey="sk-xxx"
    // リージョンごとに API キーが異なります。API キーの取得方法: https://www.alibabacloud.com/help/en/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/fox.mp3")
                        .negativePrompt("")
                        .size("1280*720")
                        .duration(10)
                        .parameters(parameters)
                        .build();

        // 非同期呼び出し
        VideoSynthesisResult task = vs.asyncCall(param);
        System.out.println(JsonUtils.toJson(task));
        System.out.println("しばらくお待ちください...");

        // 結果を取得
        VideoSynthesisResult result = vs.wait(task, apiKey);
        System.out.println(JsonUtils.toJson(result));
    }

     // タスク一覧を取得
    public static void listTask() throws ApiException, NoApiKeyException {
        VideoSynthesis is = new VideoSynthesis();
        AsyncTaskListParam param = AsyncTaskListParam.builder().build();
        param.setApiKey(apiKey);
        VideoSynthesisListResult result = is.list(param);
        System.out.println(result);
    }

    // 単一タスクの結果を取得
    public static void fetchTask(String taskId) throws ApiException, NoApiKeyException {
        VideoSynthesis is = new VideoSynthesis();
        // DASHSCOPE_API_KEY が環境変数として設定されている場合、apiKey は null にできます。
        VideoSynthesisResult result = is.fetch(taskId, apiKey);
        System.out.println(result.getOutput());
        System.out.println(result.getUsage());
    }

    public static void main(String[] args) {
        try {
            text2Video();
        } catch (ApiException | NoApiKeyException | InputRequiredException e) {
            System.out.println(e.getMessage());
        }
        System.exit(0);
    }
}

レスポンス例

1. タスク作成リクエストに対するレスポンスの例。

{
        "request_id": "5dbf9dc5-4f4c-9605-85ea-xxxxxxxx",
	"output": {
		"task_id": "7277e20e-aa01-4709-xxxxxxxx",
		"task_status": "PENDING"
	}
}

2. タスク照会リクエストに対するレスポンスの例

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": ""
}

制限事項

データの有効期限: タスクの task_id および動画の video_url は 24 時間のみ保持されます。有効期限が切れると、それらを照会またはダウンロードできなくなります。
コンテンツモデレーション: 入力コンテンツおよび出力動画の両方がコンテンツモデレーションの対象となります。禁止されたコンテンツを含むリクエストは、「IPInfringementSuspect」または「DataInspectionFailed」エラーを返します。詳細については、「エラーメッセージ」をご参照ください。

エラーコード

モデルの呼び出しが失敗してエラーメッセージが返された場合は、「エラーメッセージ」を参照して問題を解決してください。

よくある質問

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() # HTTP ステータスコードが 200 でない場合、例外を発生
        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 時間で有効期限が切れるためです。ベストプラクティスは、バックエンドで動画をダウンロードして保存し、新しい永続的なリンクを使用して再生することです。

Q: 動画ストレージのドメイン名ホワイトリストを取得するにはどうすればよいですか？

A: モデルによって生成された動画は OSS に保存されます。API は一時的な公開 URL を返します。このダウンロード URL のファイアウォールホワイトリストを設定する場合、以下の点にご注意ください。基盤となるストレージは動的に変更される可能性があります。このトピックでは、情報の陳腐化によるアクセス障害を防ぐため、固定の OSS ドメイン名ホワイトリストを提供していません。セキュリティ制御の要件がある場合は、アカウントマネージャーに連絡して、最新の OSS ドメイン名リストを取得してください。

リクエストパラメーター	マルチショットナラティブこの機能は wan2.6 シリーズのモデルのみでサポートされています。この機能を有効にするには、`"prompt_extend": true` および `"shot_type":"multi"` を設定します。 curl --location 'https://dashscope-intl.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/fox.mp3" }, "parameters": { "size": "1280720", "prompt_extend": true, "duration": 10, "shot_type":"multi" } }' 自動ダブリングこの機能は wan2.6 および wan2.5 シリーズのモデルのみでサポートされています。 `input.audio_url` を指定しない場合、モデルは動画コンテンツに基づいて、適切なバックグラウンド音楽または効果音を自動生成します。 curl --location 'https://dashscope-intl.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.5-t2v-preview", "input": { "prompt": "ローアングル、中距離クローズアップ、暖色調、混合照明（デスクランプの実用光と窓からの曇天光が混ざり合う）、サイドライティング、中央構図。クラシックな探偵事務所で、木製の本棚には古びた事件ファイルと灰皿が並んでいます。緑色のデスクランプが、デスク中央に広げられた事件ファイルを照らしています。茶色のトレンチコートと薄灰色のフェドラ帽を着用した赤毛のキツネが革張りの椅子に座り、しっぽを端に軽く乗せ、黄色くなったページをゆっくりとめくっています。外には青空の下、じっとりとした小雨が降っており、ガラスにうねるような筋が走っています。キツネはゆっくりと頭を上げ、耳をわずかに震わせ、琥珀色の目でカメラをじっと見つめ、滑らかで皮肉な声でこう話しています。「この事件は冷めていた。冬の魚よりも冷めていた。だが、すべてのニワトリには秘密がある。そして私は、その秘密を明らかにするつもりだ。」" }, "parameters": { "size": "832480", "prompt_extend": true, "duration": 10 } }' 音声ファイルの提供この機能は wan2.6 および wan2.5 シリーズのモデルのみでサポートされています。 `input.audio_url` パラメーターを使用して、カスタム音声ファイルの URL を指定できます。 curl --location 'https://dashscope-intl.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.5-t2v-preview", "input": { "prompt": "ローアングル、中距離クローズアップ、暖色調、混合照明（デスクランプの実用光と窓からの曇天光が混ざり合う）、サイドライティング、中央構図。クラシックな探偵事務所で、木製の本棚には古びた事件ファイルと灰皿が並んでいます。緑色のデスクランプが、デスク中央に広げられた事件ファイルを照らしています。茶色のトレンチコートと薄灰色のフェドラ帽を着用した赤毛のキツネが革張りの椅子に座り、しっぽを端に軽く乗せ、黄色くなったページをゆっくりとめくっています。外には青空の下、じっとりとした小雨が降っており、ガラスにうねるような筋が走っています。キツネはゆっくりと頭を上げ、耳をわずかに震わせ、琥珀色の目でカメラをじっと見つめ、滑らかで皮肉な声でこう話しています。「この事件は冷めていた。冬の魚よりも冷めていた。だが、すべてのニワトリには秘密がある。そして私は、その秘密を明らかにするつもりだ。」", "audio_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250929/stjqnq/fox.mp3" }, "parameters": { "size": "832480", "prompt_extend": true, "duration": 10 } }' 無音動画の生成無音動画の生成は、wan2.2 および wan2.1 シリーズのモデルのみでサポートされています。無音動画はデフォルトで生成されるため、特別な設定は不要です。 wan2.6 および wan2.5 シリーズのモデルでは、デフォルトで音声付き動画が生成されます。 curl --location 'https://dashscope-intl.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.2-t2v-plus", "input": { "prompt": "低コントラスト、レトロな 70 年代風地下鉄駅。薄暗い色合いと粗い質感の中で、路上ミュージシャンが演奏しています。古いスタイルのジャケットを着てギターを抱え、集中して演奏しています。通勤客が急ぎ足で通り過ぎ、少しずつ小さな聴衆が集まり始めています。カメラは右方向にゆっくりパンし、楽器の音が街の喧騒と交じり合うシーンを捉えます。背景にはレトロな地下鉄の標識と斑点模様の壁があります。" }, "parameters": { "size": "832480", "prompt_extend": true } }' ネガティブプロンプトの使用 negative_prompt を使用して、「花」要素を除外し、動画内に出現しないようにします。 `curl --location 'https://dashscope-intl.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.2-t2v-plus", "input": { "prompt": "月明かりの下を走る子猫", "negative_prompt": "flower" }, "parameters": { "size": "832*480" } }'`
ヘッダー
Content-Type `文字列` （必須）リクエストのコンテンツタイプです。値は `application/json` である必要があります。
Authorization `文字列` (必須) Model Studio API キーを使用した認証情報です。例： `Bearer sk-xxxx`
X-DashScope-Async `文字列` （必須）非同期処理を有効化します。HTTP リクエストは非同期処理のみをサポートするため、値は必ず `enable` とする必要があります。重要このヘッダーが含まれていない場合、「current user api does not support synchronous calls」エラーが返されます。
リクエスト本文
model `文字列` (必須) モデル名です。モデルおよび価格のリストについては、「モデル価格」をご参照ください。例： wan2.6-t2v
input `オブジェクト` （必須）プロンプトを含む基本的な入力情報です。プロパティ prompt `文字列` （必須）生成される動画の望ましいコンテンツおよび視覚的特徴を記述するテキストプロンプトです。中国語および英語の両方をサポートします。中国語の1文字または英字1文字を1文字としてカウントします。文字数制限を超えた部分は自動的に切り捨てられます。文字数制限はモデルバージョンによって異なります： wan2.6 および wan2.5 シリーズのモデル：最大 1,500 文字。 wan2.2 および wan2.1 シリーズのモデル：最大 800 文字。例：月明かりの下で走る子猫。ヒントについては、「テキストから動画へ／イメージから動画へ：プロンプトガイド」をご参照ください。 negative_prompt `文字列` （任意）動画から除外したいコンテンツを記述するネガティブプロンプトです。出力内容を制約するのに役立ちます。中国語および英語の両方をサポートします。文字数は最大 500 文字までです。文字数制限を超えた部分は自動的に切り捨てられます。例：解像度が低い、エラー、最悪の品質、低品質、変形、余分な指、不自然な比率。 audio_url `文字列` （任意）対応モデル：wan2.6 および wan2.5。音声ファイルの URL です。この音声に合わせて動画の生成が同期されます。対応する入力フォーマットは以下のとおりです：公開 URL： HTTP および HTTPS プロトコルをサポートします。例：https://help-static-aliyun-doc.aliyuncs.com/xxx.mp3。音声の制限事項：フォーマット：WAV、MP3。再生時間：3～30 秒。ファイルサイズ：最大 15 MB。制限超過時の処理：音声の再生時間が `duration` 値（例：5 秒）を超える場合、先頭 5 秒のみが使用され、残りは破棄されます。また、音声の再生時間が動画の再生時間より短い場合は、動画の残りの部分は無音になります。たとえば、音声が 3 秒、動画の再生時間が 5 秒の場合、出力動画の最初の 3 秒は音声付きとなり、最後の 2 秒は無音となります。
パラメーター `オブジェクト`（任意）動画処理のパラメーター。解像度、プロンプト再書き込み、ウォーターマークの付与を含みます。プロパティ size `文字列`（任意）重要 `size` パラメーターはコストに直接影響します。コスト＝解像度に基づく単価 × 処理時間（秒）。同一モデルにおいて、1080P ＞ 720P ＞ 480P です。API を呼び出す前に、「モデルの課金情報」をご参照ください。 `size` には、`1:1` や `480P` のような比率または階層ではなく、``1280720`` のような具体的な値を指定する必要があります。生成される動画の解像度を ``幅高さ`` のフォーマットで指定します。このパラメーターのデフォルト値および利用可能な列挙値は、`model` パラメーターに依存し、以下のとおりです： wan2.6-t2v：デフォルト値は ``19201080``（1080P）。選択可能な解像度：720P および 1080P に対応するすべての解像度。 wan2.6-t2v-us：デフォルト値は ``19201080``（1080P）。利用可能な解像度：720P および 1080P に対応するすべての解像度。 wan2.5-t2v-preview：デフォルト値は ``19201080``（1080P）。選択可能な解像度：480P、720P、および 1080P に対応するすべての解像度。 wan2.2-t2v-plus：デフォルト値は ``19201080``（1080P）。選択可能な解像度：480P および 1080P に対応するすべての解像度。 wan2.1-t2v-turbo：デフォルト値は ``1280720``（720P）。選択可能な解像度：480P および 720P に対応するすべての解像度。 wan2.1-t2v-plus：デフォルト値は ``1280720``（720P）。選択可能な解像度：720P に対応するすべての解像度。 480P 階層：選択可能な動画解像度および対応する縦横比は以下のとおりです。 `832480`：16:9。 `480832`：9:16。 `624624`：1:1。 720P 階層：選択可能な動画解像度および対応する縦横比は以下のとおりです。 `1280720`：16:9。 `7201280`：9:16。 `960960`：1:1。 `1088832`：4:3。 `8321088`：3:4。 1080P 階層：選択可能な動画解像度および対応する縦横比は以下のとおりです。 `19201080`：16:9。 `10801920`：9:16。 `14401440`：1:1。 `16321248`：4:3。 `12481632`：3:4。 duration* `整数`（任意）重要 `duration` パラメーターはコストに直接影響します。コスト＝解像度に基づく単価 × 処理時間（秒）。API を呼び出す前に、「モデルの課金情報」をご参照ください。生成される動画の長さ（秒単位）。このパラメーターの値は、`model` パラメーターに依存します： 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 秒（変更不可）。例：5。 prompt_extend `ブール値`（任意）。デフォルト値は `true`。プロンプト再書き込みを有効にするかどうか。有効にすると、LLM が入力プロンプトを再書き込みします。短いプロンプトの場合、生成品質が大幅に向上しますが、処理時間も延長されます。 true false 例：`true` shot_type `文字列`（任意）対応モデル：wan2.6 シリーズのモデル。生成される動画のショットタイプ（単一連続ショットか、複数の切り替わりショットか）を指定します。効果が適用される条件：このパラメーターは、``"prompt_extend": true`` の場合のみ有効です。パラメーターの優先順位：``shot_type > prompt``。たとえば、`shot_type` を `"single"` に設定した場合、プロンプトに「マルチショット動画を生成」と記述されていても、モデルは単一ショットの動画を出力します。選択可能な値： single（デフォルト） multi 例：single。説明動画のナラティブ構造を厳密に制御する必要がある場合に使用します。たとえば、製品紹介には単一ショット、短編ストーリーには複数ショットを用いるなどです。 watermark `ブール値`（任意）ウォーターマークを付与するかどうかを指定します。ウォーターマークは動画の右下隅に固定位置で表示され、「AI Generated」というテキストが含まれます。 false（デフォルト） true 例：false。 seed `整数`（任意）乱数シード。``0`` から ``2147483647`` の範囲の整数である必要があります。指定しない場合、ランダムなシードが自動生成されます。固定のシードを使用すると再現性が向上しますが、モデル固有のランダム性により結果が若干異なる場合があります。例：`12345`

応答パラメーター	タスクが正常に実行されました動画 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": "Shot from a low angle, in a medium close-up, with warm tones, mixed lighting (the practical light from the desk lamp blends with the overcast light from the window), side lighting, and a central composition. In a classic detective's office, wooden bookshelves are filled with old case files and ashtrays. A green desk lamp illuminates a case file spread out in the center of the desk. A fox, wearing a dark brown trench coat and a light gray fedora, sits in a leather chair, its fur crimson, its tail resting lightly on the edge, its fingers slowly turning yellowed pages. Outside, a steady drizzle falls beneath a blue sky, streaking the glass with meandering streaks. It slowly raises its head, its ears twitching slightly, its amber eyes gazing directly at the camera, its mouth clearly moving as it speaks in a smooth, cynical voice: 'The case was cold, colder than a fish in winter. But every chicken has its secrets, and I, for one, intended to find them '. ", "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 } } タスク実行失敗時タスクが失敗すると、`task_status` は FAILED に設定され、エラーコードとエラーメッセージが返されます。問題を解決するには、「エラーコード」をご参照ください。 `{ "request_id": "e5d70b02-ebd3-98ce-9fe8-759d7d7b107d", "output": { "task_id": "86ecf553-d340-4e21-af6e-a0c6a421c010", "task_status": "FAILED", "code": "InvalidParameter", "message": "The size is not match xxxxxx" } }` タスククエリ期限切れ時 `task_id` の有効期間は 24 時間です。この期間を過ぎるとクエリは失敗し、以下のエラーメッセージが返されます。 `{ "request_id": "a4de7c32-7057-9f82-8581-xxxxxx", "output": { "task_id": "502a00b1-19d9-4839-a82f-xxxxxx", "task_status": "UNKNOWN" } }`
output `オブジェクト` タスクの出力情報です。プロパティ task_id `文字列` タスクの ID です。最大 24 時間までタスクのクエリに使用できます。 task_status `文字列` タスクのステータスです。列挙値 PENDING RUNNING SUCCEEDED FAILED CANCELED UNKNOWN：タスクが存在しない、またはステータス不明ポーリング時のステータストランジション： PENDING → RUNNING → SUCCEEDED または FAILED 初回クエリでは通常 PENDING または RUNNING が返されます SUCCEEDED ステータスの場合、応答に生成された動画の URL が含まれます FAILED ステータスの場合、エラーメッセージを確認して再試行してください submit_time `文字列` タスクの送信時刻です。時刻は UTC + 08:00 です。フォーマット： `YYYY-MM-DD HH:mm:ss.SSS`。 scheduled_time `文字列` タスクの実行開始時刻です。時刻は UTC + 08:00 です。フォーマット： `YYYY-MM-DD HH:mm:ss.SSS`。 end_time `文字列` タスクの完了時刻です。時刻は UTC + 08:00 です。フォーマット： `YYYY-MM-DD HH:mm:ss.SSS`。 video_url `文字列` 生成された動画の URL です。`task_status` が SUCCEEDED の場合にのみ返されます。 URL の有効期間は 24 時間です。H.264 エンコーディングで MP4 形式の動画をダウンロードするために使用します。 orig_prompt `文字列` 元の入力プロンプトです。これは `prompt` リクエストパラメーターの値です。 actual_prompt `文字列` `prompt_extend=true` の場合、システムは入力プロンプトに対してプロンプトリライトを行います。このフィールドは、実際に生成に使用された最適化済みプロンプトを返します。 `prompt_extend=false` の場合、このフィールドは返されません。注：wan2.6 モデルは、`prompt_extend` の値に関係なく、このフィールドを返しません。 code `文字列` エラーコードです。リクエストが失敗した場合にのみ返されます。詳細については、「エラーコード」をご参照ください。 message `文字列` 詳細なエラーメッセージです。リクエストが失敗した場合にのみ返されます。詳細については、「エラーコード」をご参照ください。
usage `オブジェクト` 出力に関する統計情報です。成功した結果のみがカウントされます。プロパティ video_duration `整数` wan2.5 以前のモデルを使用している場合にのみ返されます。課金に使用されます。生成された動画の長さ（秒単位）です。列挙値は 5 および 10 です。 duration `浮動小数点数` wan2.6 モデルを使用している場合にのみ返されます。課金に使用されます。合計動画長を示します。`duration=input_video_duration+output_video_duration` です。 input_video_duration `整数` wan2.6 モデルを使用している場合にのみ返されます。値は固定で 0 です。 output_video_duration `整数` wan2.6 モデルを使用している場合に返されます。出力動画の長さ（秒単位）です。`input.duration` の値と同じになります。 SR `整数` wan2.6 モデルを使用している場合に返されます。生成された動画の解像度階層です。例：720。 size `文字列` wan2.6 モデルを使用する場合にのみ返されます。生成された動画の解像度です。フォーマットは「幅高さ」です。例: 19201080。 video_ratio `文字列` wan2.5 以前のモデルを使用する場合にのみ返されます。生成された動画の解像度です。フォーマットは「幅高さ」です。例: 832480。 video_count `整数` 生成された動画の数です。値は固定で 1 です。
request_id `文字列` リクエストの一意な識別子です。トレースおよび問題のトラブルシューティングに使用します。

可用性

HTTP

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

シンガポール

米国 (バージニア)

北京

リクエストパラメーター

マルチショットナラティブ

自動ダブリング

音声ファイルの提供

無音動画の生成

ネガティブプロンプトの使用

ヘッダー

リクエスト本文

応答パラメーター

成功応答

エラー応答

ステップ 2：結果のクエリ

シンガポール

米国 (バージニア)

北京

リクエストパラメーター

タスク結果のクエリ

ヘッダー

パスパラメーター

応答パラメーター

タスクが正常に実行されました

タスク実行失敗時

タスククエリ期限切れ時

DashScope SDK

Python SDK

同期呼び出し

リクエスト例

レスポンス例

非同期呼び出し

リクエスト例

レスポンス例

Java SDK

シンガポール

米国 (バージニア)

北京

同期呼び出し

リクエスト例

レスポンス例

非同期呼び出し

リクエスト例

レスポンス例

制限事項

エラーコード

よくある質問

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

Q: 返された動画リンクをブラウザで直接再生できますか？

Q: 動画ストレージのドメイン名ホワイトリストを取得するにはどうすればよいですか？