Wanxiang テキストからビデオ API リファレンス - Alibaba Cloud Model Studio

Wanxiang テキストからビデオモデルは、テキストプロンプトに基づいてスムーズなビデオを生成します。

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

適用範囲

呼び出しを成功させるには、モデル、エンドポイント URL、および API キーがすべて同じリージョンに属していることを確認してください。リージョンをまたぐ呼び出しは失敗します。

モデルの選択: モデルのリージョンを確認します。
URL の選択: 対応するリージョンのエンドポイント URL を選択します。HTTP URL と DashScope SDK URL の両方がサポートされています。
API キーの設定: リージョンを選択し、API キーと API ホストを取得します。次に、API キーを環境変数として設定します (未公開で API キーの設定にマージされます)。
SDK のインストール: SDK を使用して API を呼び出す場合は、DashScope SDK をインストールします。

説明

このトピックのサンプルコードは、シンガポール リージョンに適用されます。

HTTP 呼び出し

テキストからビデオへのタスクは通常 1 ～ 5 分かかるため、API は非同期呼び出しを使用します。プロセスには、タスクの作成 -> 結果のポーリングという 2 つのコアステップが含まれます。

ステップ 1: タスクを作成してタスク ID を取得

シンガポール

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": "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 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 \"。", "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` を指定しない場合、モデルはビデオコンテンツに基づいて一致する BGM または効果音を自動的に生成します。 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": "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 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 \"" }, "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: 有効' \ -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": "Low contrast, in a retro 70s style subway station, a street musician plays amidst dim colors and rough textures. He wears an old-style jacket, holds a guitar, and plays with concentration. Commuters hurry past, and a small crowd gradually gathers to listen. The camera slowly pans to the right, capturing the scene where the sound of the instrument intertwines with the city's hustle and bustle, with old-fashioned subway signs and mottled walls in the background." }, "parameters": { "size": "832480", "prompt_extend": true } }' ネガティブプロンプトの使用 `negative_prompt` を使用して「flower」要素を除外し、ビデオに表示されないようにします。 `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": "A kitten running in the moonlight", "negative_prompt": "flower" }, "parameters": { "size": "832*480" } }'`
ヘッダー
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 文字に制限されています。制限を超えるテキストは自動的に切り捨てられます。例: low resolution, error, worst quality, low quality, deformed, extra fingers, bad proportions。 audio_url `string` (オプション) サポートされているモデル: 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 秒はサイレントになります。
parameters `object` (オプション) 画像編集パラメーター。これらを使用して、ビデオ解像度の設定、プロンプトの再書き込みの有効化、ウォーターマークの追加などを行います。プロパティ size `string` (オプション) 重要 `size` パラメーターはコストに直接影響します。コスト = 単価 (解像度に基づく) × 期間 (秒)。同じモデルの場合、1080P > 720P > 480P です。呼び出しを行う前に、モデルの料金を確認してください。 `size` は、1:1 や 480P のティアのような比率ではなく、特定の値 (例: `1280720`) に設定する必要があります。生成されるビデオの解像度を `widthheight` 形式で指定します。このパラメーターのデフォルト値と利用可能な列挙値は、`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* `integer` (オプション) 重要 `duration` パラメーターはコストに直接影響します。コスト = 単価 (解像度に基づく) × 期間 (秒)。呼び出しを行う前に、モデルの料金を確認してください。生成されるビデオの期間 (秒単位)。このパラメーターの値は、`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 `boolean` (オプション) デフォルトは `true` プロンプトの再書き込みを有効にするかどうか。有効にすると、LLM が入力プロンプトを再書き込みします。これにより、短いプロンプトの生成品質が大幅に向上する可能性がありますが、処理時間も増加します。 true false 例: `true` shot_type `string` (オプション) サポートされているモデル: wan2.6 シリーズモデル。生成されるビデオのショットタイプを指定します。これにより、ビデオが単一の連続ショットで構成されるか、複数の変化するショットで構成されるかが決まります。効果の条件: このパラメーターは、`"prompt_extend": true` の場合にのみ有効になります。パラメーターの優先度: `shot_type > prompt`。たとえば、`shot_type` が「single」に設定されている場合、プロンプトに「generate a multi-shot video」が含まれていても、モデルは単一ショットのビデオを出力します。オプションの値: single (デフォルト): 単一ショットのビデオを出力します。 multi: マルチショットのビデオを出力します。例: single。説明このパラメーターは、製品表示に単一ショットを使用したり、短編ストーリーに複数ショットを使用したりするなど、ビデオのナラティブ構造を厳密に制御する必要がある場合に使用します。 watermark `boolean` (オプション) ウォーターマークを追加するかどうかを指定します。ウォーターマークは、固定テキスト「AI Generated」とともにビデオの右下隅に配置されます。 false (デフォルト): ウォーターマークは追加されません。 true: ウォーターマークが追加されます。例: false。 seed `integer` (オプション) 乱数シードです。`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 `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://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 `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": "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 `object` タスク出力情報。プロパティ 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 の場合にのみ返されます。 URL は 24 時間有効です。H.264 エンコーディングの MP4 形式でビデオをダウンロードするために使用します。 orig_prompt `string` 元の入力プロンプトで、`prompt` リクエストパラメーターの値です。 actual_prompt `string` `prompt_extend=true` の場合、システムは入力プロンプトに対してプロンプトの再書き込みを実行します。このフィールドは、実際に生成に使用された最適化されたプロンプトを返します。 `prompt_extend=false` の場合、このフィールドは返されません。注: wan2.6 モデルは、`prompt_extend` の値に関係なく、このフィールドを返しません。 code `string` エラーコード。リクエストが失敗した場合にのみ返されます。詳細については、「エラーコード」をご参照ください。 message `string` 詳細なエラーメッセージ。リクエストが失敗した場合にのみ返されます。詳細については、「エラーコード」をご参照ください。
usage `object` 出力の統計。成功した結果のみがカウントされます。プロパティ video_duration `integer` wan2.5 以前のモデルを使用している場合にのみ返されます。課金に使用されます。生成されたビデオの期間 (秒単位)。列挙値は 5 と 10 です。 duration `float` wan2.6 モデルを使用している場合にのみ返されます。課金に使用されます。合計ビデオ期間を示します。`duration=input_video_duration+output_video_duration`。 input_video_duration `integer` wan2.6 モデルを使用している場合にのみ返されます。値は 0 に固定されています。 output_video_duration `integer` wan2.6 モデルを使用している場合にのみ返されます。出力ビデオの期間 (秒単位)。その値は `input.duration` の値と同じです。 SR `integer` wan2.6 モデルを使用している場合にのみ返されます。生成されたビデオの解像度ティア。例: 720。 size `string` wan2.6 モデルを使用している場合にのみ返されます。生成されたビデオの解像度。形式は「widthheight」です。例: 19201080。 video_ratio `string` wan2.5 以前のモデルを使用している場合にのみ返されます。生成されたビデオの解像度。形式は「widthheight」です。例: 832480。 video_count `integer` 生成されたビデオの数。値は 1 に固定されています。
request_id `string` リクエストの一意の識別子。問題の追跡とトラブルシューティングに使用します。

DashScope SDK 呼び出し

SDK 内のパラメーター名は、HTTP API とほぼ一致しています。パラメーターの構造は、各プログラミング言語に応じて最適化されています。

テキストから動画を生成するタスク（text-to-video）は処理に時間がかかるため、通常 1～5 分程度かかります。このため、DashScope 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"
# リージョンごとに Model Studio 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='低角度からのショット、中間寄りのクローズアップ、暖色系のトーン、混合照明（デスクランプの実用光と窓からの曇天光が混ざり合う）、サイドライティング、センター構図。クラシックな探偵事務所内には、木製の本棚が古びた事件ファイルと灰皿で満たされています。緑色のデスクランプが、デスク中央に広げられた事件ファイルを照らしています。茶褐色のトレンチコートと薄灰色のフェドラ帽を着用したキツネが、革張りの椅子に座っています。その毛並みは深紅色で、尾は軽やかに椅子の端に rests しており、指はゆっくりと黄ばんだページをめくります。外には、青空の下で一定の霧雨が降り、ガラスに蛇行する筋を描いています。キツネはゆっくりと頭を上げ、耳をわずかにぴくつかせ、琥珀色の目をカメラに向かってまっすぐに見据え、滑らかで皮肉な声でこう語ります。「この事件は冷めていた。冬の魚よりも冷めていた。だが、どんな鶏にも秘密はある。そして私は、それらをすべて見つけ出すつもりだ。」',
                              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": "低角度からのショット、中間寄りのクローズアップ、暖色系のトーン、混合照明（デスクランプの実用光と窓からの曇天光が混ざり合う）、サイドライティング、センター構図。クラシックな探偵事務所内には、木製の本棚が古びた事件ファイルと灰皿で満たされています。緑色のデスクランプが、デスク中央に広げられた事件ファイルを照らしています。茶褐色のトレンチコートと薄灰色のフェドラ帽を着用したキツネが、革張りの椅子に座っています。その毛並みは深紅色で、尾は軽やかに椅子の端に rests しており、指はゆっくりと黄ばんだページをめくります。外には、青空の下で一定の霧雨が降り、ガラスに蛇行する筋を描いています。キツネはゆっくりと頭を上げ、耳をわずかにぴくつかせ、琥珀色の目をカメラに向かってまっすぐに見据え、滑らかで皮肉な声でこう語ります。「この事件は冷めていた。冬の魚よりも冷めていた。だが、どんな鶏にも秘密はある。そして私は、それらをすべて見つけ出すつもりだ。」"
    },
    "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"
# リージョンごとに Model Studio 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='低角度からのショット、中間寄りのクローズアップ、暖色系のトーン、混合照明（デスクランプの実用光と窓からの曇天光が混ざり合う）、サイドライティング、センター構図。クラシックな探偵事務所内には、木製の本棚が古びた事件ファイルと灰皿で満たされています。緑色のデスクランプが、デスク中央に広げられた事件ファイルを照らしています。茶褐色のトレンチコートと薄灰色のフェドラ帽を着用したキツネが、革張りの椅子に座っています。その毛並みは深紅色で、尾は軽やかに椅子の端に rests しており、指はゆっくりと黄ばんだページをめくります。外には、青空の下で一定の霧雨が降り、ガラスに蛇行する筋を描いています。キツネはゆっくりと頭を上げ、耳をわずかにぴくつかせ、琥珀色の目をカメラに向かってまっすぐに見据え、滑らかで皮肉な声でこう語ります。「この事件は冷めていた。冬の魚よりも冷めていた。だが、どんな鶏にも秘密はある。そして私は、それらをすべて見つけ出すつもりだ。」',
                                    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": "低角度からのショット、中間寄りのクローズアップ、暖色系のトーン、混合照明（デスクランプの実用光と窓からの曇天光が混ざり合う）、サイドライティング、センター構図。クラシックな探偵事務所内には、木製の本棚が古びた事件ファイルと灰皿で満たされています。緑色のデスクランプが、デスク中央に広げられた事件ファイルを照らしています。茶褐色のトレンチコートと薄灰色のフェドラ帽を着用したキツネが、革張りの椅子に座っています。その毛並みは深紅色で、尾は軽やかに椅子の端に rests しており、指はゆっくりと黄ばんだページをめくります。外には、青空の下で一定の霧雨が降り、ガラスに蛇行する筋を描いています。キツネはゆっくりと頭を上げ、耳をわずかにぴくつかせ、琥珀色の目をカメラに向かってまっすぐに見据え、滑らかで皮肉な声でこう語ります。「この事件は冷めていた。冬の魚よりも冷めていた。だが、どんな鶏にも秘密はある。そして私は、それらをすべて見つけ出すつもりだ。」"
    },
    "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"
    // リージョンごとに Model Studio 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("低角度からのショット、中間寄りのクローズアップ、暖色系のトーン、混合照明（デスクランプの実用光と窓からの曇天光が混ざり合う）、サイドライティング、センター構図。クラシックな探偵事務所内には、木製の本棚が古びた事件ファイルと灰皿で満たされています。緑色のデスクランプが、デスク中央に広げられた事件ファイルを照らしています。茶褐色のトレンチコートと薄灰色のフェドラ帽を着用したキツネが、革張りの椅子に座っています。その毛並みは深紅色で、尾は軽やかに椅子の端に rests しており、指はゆっくりと黄ばんだページをめくります。外には、青空の下で一定の霧雨が降り、ガラスに蛇行する筋を描いています。キツネはゆっくりと頭を上げ、耳をわずかにぴくつかせ、琥珀色の目をカメラに向かってまっすぐに見据え、滑らかで皮肉な声でこう語ります。「この事件は冷めていた。冬の魚よりも冷めていた。だが、どんな鶏にも秘密はある。そして私は、それらをすべて見つけ出すつもりだ。」")
                        .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": "低角度からのショット、中間寄りのクローズアップ、暖色系のトーン、混合照明（デスクランプの実用光と窓からの曇天光が混ざり合う）、サイドライティング、センター構図。クラシックな探偵事務所内には、木製の本棚が古びた事件ファイルと灰皿で満たされています。緑色のデスクランプが、デスク中央に広げられた事件ファイルを照らしています。茶褐色のトレンチコートと薄灰色のフェドラ帽を着用したキツネが、革張りの椅子に座っています。その毛並みは深紅色で、尾は軽やかに椅子の端に rests しており、指はゆっくりと黄ばんだページをめくります。外には、青空の下で一定の霧雨が降り、ガラスに蛇行する筋を描いています。キツネはゆっくりと頭を上げ、耳をわずかにぴくつかせ、琥珀色の目をカメラに向かってまっすぐに見据え、滑らかで皮肉な声でこう語ります。「この事件は冷めていた。冬の魚よりも冷めていた。だが、どんな鶏にも秘密はある。そして私は、それらをすべて見つけ出すつもりだ。」",
        "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"
    // リージョンごとに Model Studio 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("低角度からのショット、中間寄りのクローズアップ、暖色系のトーン、混合照明（デスクランプの実用光と窓からの曇天光が混ざり合う）、サイドライティング、センター構図。クラシックな探偵事務所内には、木製の本棚が古びた事件ファイルと灰皿で満たされています。緑色のデスクランプが、デスク中央に広げられた事件ファイルを照らしています。茶褐色のトレンチコートと薄灰色のフェドラ帽を着用したキツネが、革張りの椅子に座っています。その毛並みは深紅色で、尾は軽やかに椅子の端に rests しており、指はゆっくりと黄ばんだページをめくります。外には、青空の下で一定の霧雨が降り、ガラスに蛇行する筋を描いています。キツネはゆっくりと頭を上げ、耳をわずかにぴくつかせ、琥珀色の目をカメラに向かってまっすぐに見据え、滑らかで皮肉な声でこう語ります。「この事件は冷めていた。冬の魚よりも冷めていた。だが、どんな鶏にも秘密はある。そして私は、それらをすべて見つけ出すつもりだ。」")
                        .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": "低角度からのショット、中間寄りのクローズアップ、暖色系のトーン、混合照明（デスクランプの実用光と窓からの曇天光が混ざり合う）、サイドライティング、センター構図。クラシックな探偵事務所内には、木製の本棚が古びた事件ファイルと灰皿で満たされています。緑色のデスクランプが、デスク中央に広げられた事件ファイルを照らしています。茶褐色のトレンチコートと薄灰色のフェドラ帽を着用したキツネが、革張りの椅子に座っています。その毛並みは深紅色で、尾は軽やかに椅子の端に rests しており、指はゆっくりと黄ばんだページをめくります。外には、青空の下で一定の霧雨が降り、ガラスに蛇行する筋を描いています。キツネはゆっくりと頭を上げ、耳をわずかにぴくつかせ、琥珀色の目をカメラに向かってまっすぐに見据え、滑らかで皮肉な声でこう語ります。「この事件は冷めていた。冬の魚よりも冷めていた。だが、どんな鶏にも秘密はある。そして私は、それらをすべて見つけ出すつもりだ。」",
        "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」エラーを返します。詳細については、「エラーメッセージ」をご参照ください。

ネットワークアクセス構成：動画リンクは Object Storage Service (OSS) に保存されます。セキュリティポリシーにより、ご利用の業務システムが外部 OSS リンクにアクセスできない場合、以下の OSS ドメイン名をネットワークアクセスホワイトリストに追加してください。

# OSS ドメイン名一覧
dashscope-result-bj.oss-cn-beijing.aliyuncs.com
dashscope-result-hz.oss-cn-hangzhou.aliyuncs.com
dashscope-result-sh.oss-cn-shanghai.aliyuncs.com
dashscope-result-wlcb.oss-cn-wulanchabu.aliyuncs.com
dashscope-result-zjk.oss-cn-zhangjiakou.aliyuncs.com
dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com
dashscope-result-hy.oss-cn-heyuan.aliyuncs.com
dashscope-result-cd.oss-cn-chengdu.aliyuncs.com
dashscope-result-gz.oss-cn-guangzhou.aliyuncs.com
dashscope-result-wlcb-acdr-1.oss-cn-wulanchabu-acdr-1.aliyuncs.com

エラーコード

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

よくある質問

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

A：リンクを直接変換することはできません。正しい方法は、ご利用のバックエンドサービスで URL を取得し、プログラムでビデオファイルをダウンロードした後、Alibaba Cloud Object Storage Service (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"Video successfully downloaded to: {save_path}")
        # ここに永続ストレージにアップロードするロジックを追加できます
    except requests.exceptions.RequestException as e:
        print(f"Failed to download video: {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 時間で有効期限が切れるためです。ベストプラクティスは、ご利用のバックエンドでビデオをダウンロードして保存し、新しい永続的なリンクを再生に使用することです。

リクエストパラメーター	マルチショットナラティブこの機能は 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": "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 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 \"。", "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` を指定しない場合、モデルはビデオコンテンツに基づいて一致する BGM または効果音を自動的に生成します。 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": "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 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 \"" }, "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: 有効' \ -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": "Low contrast, in a retro 70s style subway station, a street musician plays amidst dim colors and rough textures. He wears an old-style jacket, holds a guitar, and plays with concentration. Commuters hurry past, and a small crowd gradually gathers to listen. The camera slowly pans to the right, capturing the scene where the sound of the instrument intertwines with the city's hustle and bustle, with old-fashioned subway signs and mottled walls in the background." }, "parameters": { "size": "832480", "prompt_extend": true } }' ネガティブプロンプトの使用 `negative_prompt` を使用して「flower」要素を除外し、ビデオに表示されないようにします。 `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": "A kitten running in the moonlight", "negative_prompt": "flower" }, "parameters": { "size": "832*480" } }'`
ヘッダー
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 文字に制限されています。制限を超えるテキストは自動的に切り捨てられます。例: low resolution, error, worst quality, low quality, deformed, extra fingers, bad proportions。 audio_url `string` (オプション) サポートされているモデル: 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 秒はサイレントになります。
parameters `object` (オプション) 画像編集パラメーター。これらを使用して、ビデオ解像度の設定、プロンプトの再書き込みの有効化、ウォーターマークの追加などを行います。プロパティ size `string` (オプション) 重要 `size` パラメーターはコストに直接影響します。コスト = 単価 (解像度に基づく) × 期間 (秒)。同じモデルの場合、1080P > 720P > 480P です。呼び出しを行う前に、モデルの料金を確認してください。 `size` は、1:1 や 480P のティアのような比率ではなく、特定の値 (例: `1280720`) に設定する必要があります。生成されるビデオの解像度を `widthheight` 形式で指定します。このパラメーターのデフォルト値と利用可能な列挙値は、`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* `integer` (オプション) 重要 `duration` パラメーターはコストに直接影響します。コスト = 単価 (解像度に基づく) × 期間 (秒)。呼び出しを行う前に、モデルの料金を確認してください。生成されるビデオの期間 (秒単位)。このパラメーターの値は、`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 `boolean` (オプション) デフォルトは `true` プロンプトの再書き込みを有効にするかどうか。有効にすると、LLM が入力プロンプトを再書き込みします。これにより、短いプロンプトの生成品質が大幅に向上する可能性がありますが、処理時間も増加します。 true false 例: `true` shot_type `string` (オプション) サポートされているモデル: wan2.6 シリーズモデル。生成されるビデオのショットタイプを指定します。これにより、ビデオが単一の連続ショットで構成されるか、複数の変化するショットで構成されるかが決まります。効果の条件: このパラメーターは、`"prompt_extend": true` の場合にのみ有効になります。パラメーターの優先度: `shot_type > prompt`。たとえば、`shot_type` が「single」に設定されている場合、プロンプトに「generate a multi-shot video」が含まれていても、モデルは単一ショットのビデオを出力します。オプションの値: single (デフォルト): 単一ショットのビデオを出力します。 multi: マルチショットのビデオを出力します。例: single。説明このパラメーターは、製品表示に単一ショットを使用したり、短編ストーリーに複数ショットを使用したりするなど、ビデオのナラティブ構造を厳密に制御する必要がある場合に使用します。 watermark `boolean` (オプション) ウォーターマークを追加するかどうかを指定します。ウォーターマークは、固定テキスト「AI Generated」とともにビデオの右下隅に配置されます。 false (デフォルト): ウォーターマークは追加されません。 true: ウォーターマークが追加されます。例: false。 seed `integer` (オプション) 乱数シードです。`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 `object` タスク出力情報。プロパティ 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 の場合にのみ返されます。 URL は 24 時間有効です。H.264 エンコーディングの MP4 形式でビデオをダウンロードするために使用します。 orig_prompt `string` 元の入力プロンプトで、`prompt` リクエストパラメーターの値です。 actual_prompt `string` `prompt_extend=true` の場合、システムは入力プロンプトに対してプロンプトの再書き込みを実行します。このフィールドは、実際に生成に使用された最適化されたプロンプトを返します。 `prompt_extend=false` の場合、このフィールドは返されません。注: wan2.6 モデルは、`prompt_extend` の値に関係なく、このフィールドを返しません。 code `string` エラーコード。リクエストが失敗した場合にのみ返されます。詳細については、「エラーコード」をご参照ください。 message `string` 詳細なエラーメッセージ。リクエストが失敗した場合にのみ返されます。詳細については、「エラーコード」をご参照ください。
usage `object` 出力の統計。成功した結果のみがカウントされます。プロパティ video_duration `integer` wan2.5 以前のモデルを使用している場合にのみ返されます。課金に使用されます。生成されたビデオの期間 (秒単位)。列挙値は 5 と 10 です。 duration `float` wan2.6 モデルを使用している場合にのみ返されます。課金に使用されます。合計ビデオ期間を示します。`duration=input_video_duration+output_video_duration`。 input_video_duration `integer` wan2.6 モデルを使用している場合にのみ返されます。値は 0 に固定されています。 output_video_duration `integer` wan2.6 モデルを使用している場合にのみ返されます。出力ビデオの期間 (秒単位)。その値は `input.duration` の値と同じです。 SR `integer` wan2.6 モデルを使用している場合にのみ返されます。生成されたビデオの解像度ティア。例: 720。 size `string` wan2.6 モデルを使用している場合にのみ返されます。生成されたビデオの解像度。形式は「widthheight」です。例: 19201080。 video_ratio `string` wan2.5 以前のモデルを使用している場合にのみ返されます。生成されたビデオの解像度。形式は「widthheight」です。例: 832480。 video_count `integer` 生成されたビデオの数。値は 1 に固定されています。
request_id `string` リクエストの一意の識別子。問題の追跡とトラブルシューティングに使用します。

適用範囲

HTTP 呼び出し

ステップ 1: タスクを作成してタスク ID を取得

シンガポール

バージニア州

北京

リクエストパラメーター

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

自動吹き替え

オーディオファイルの提供

サイレントビデオの生成

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

ヘッダー

リクエストボディ

応答パラメーター

成功応答

エラー応答

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

シンガポール

バージニア

北京

リクエストパラメーター

タスク結果のクエリ

ヘッダー

パスパラメーター

応答パラメーター

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

タスク実行の失敗

タスククエリの有効期限が切れました

DashScope SDK 呼び出し

Python SDK の呼び出し

同期呼び出し

リクエスト例

応答例

非同期呼び出し

リクエスト例

応答例

Java SDK の呼び出し

シンガポール

米国 (バージニア)

北京

同期呼び出し

リクエスト例

応答例

非同期呼び出し

リクエスト例

応答例

制限事項

エラーコード

よくある質問

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

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