Wan テキスト動画生成モデルは、 テキストプロンプト からスムーズな動画を生成します。
リファレンス: ユーザーガイド
モデル、エンドポイント URL、API キーのリージョンを一致させてください。リージョンをまたいだ呼び出しは失敗します。
テキスト動画生成タスクには 1~5 分かかります。API は非同期呼び出しを使用します:タスクを作成 → 結果をポーリング。
テキスト動画生成タスクには 1~5 分かかるため、API は非同期呼び出しを使用します:タスクを作成 → 結果をポーリング。
SDK のパラメーター名は、ほとんどが HTTP API と一致しており、構造は言語固有の規則に従います。
テキスト動画生成タスクには 1~5 分かかります。SDK は非同期 HTTP 呼び出しフローをラップし、同期および非同期の両方の呼び出しをサポートします。
モデルが属するリージョンに基づいて
Constants.baseHttpApiUrl をリージョンエンドポイントに設定します:
モデルの呼び出しが失敗し、エラーメッセージが返された場合は、「エラーコード」で解決策をご確認ください。
A:2 つの変更が必要です:
A:直接の変換はできません。URL からビデオをダウンロードし、それを永続ストレージ (Alibaba Cloud OSS など) にアップロードして永続的なリンクを生成してください。
A:いいえ。リンクは 24 時間後に有効期限が切れます。ビデオをダウンロードし、永続的に保存して、再生には永続的なリンクを使用してください。
可用性
モデル、エンドポイント URL、API キーのリージョンを一致させてください。リージョンをまたいだ呼び出しは失敗します。
- モデルの選択:モデルスクエアに移動してモデルを選択し、そのリージョンを確認します。
- URL の選択:対応するリージョンのエンドポイント URL を使用します。HTTP と HTTPS の両方がサポートされています。
- API キーの設定:リージョンを選択し、API キーを取得し、環境変数に設定します。
- SDK のインストール:SDK を介して API を呼び出すには、DashScope SDK をインストールします。
このトピックのサンプルコードでは、シンガポールリージョンを使用しています。
HTTP (wan2.7)
テキスト動画生成タスクには 1~5 分かかります。API は非同期呼び出しを使用します:タスクを作成 → 結果をポーリング。
ステップ 1:タスクの作成
- 北京
- シンガポール
POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis- シンガポール
- 中国 (北京)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis{WorkspaceId} を実際のワークスペース ID に置き換えてください。
- タスクが作成された後、返された
task_idを使用して結果をクエリします。task_idは 24 時間有効です。重複したタスクを作成しないでください。代わりに、ポーリングを使用して結果を取得してください。 - 初心者向けのガイダンスについては、「Postman または cURL で API を呼び出す」をご参照ください。
リクエストパラメーター |
prompt 内の自然言語でショット構造を制御します。shot_type パラメーターは効果がありません。
| ||||||||||||||||||||||||
ヘッダー | |||||||||||||||||||||||||
Content-Type string (必須)リクエストのコンテンツタイプは application/json である必要があります。 | |||||||||||||||||||||||||
Authorization string (必須)Model Studio API キーでリクエストを認証します。例:Bearer sk-xxxx。 | |||||||||||||||||||||||||
X-DashScope-Async string (必須)非同期処理を有効にします。HTTP リクエストは非同期呼び出しのみをサポートします。enable に設定する必要があります。 | |||||||||||||||||||||||||
リクエストボディ | |||||||||||||||||||||||||
model string (必須)モデル名。モデルと料金については、「モデルの料金」をご参照ください。例:wan2.7-t2v, wan2.7-t2v-2026-06-12。 | |||||||||||||||||||||||||
input object (必須)プロンプトを含む入力データ。
プロパティ prompt string (必須)ビデオのコンテンツと視覚スタイルを記述するテキストプロンプト。中国語と英語をサポートします。各文字または手紙は 1 つとしてカウントされます。制限を超えるテキストは自動的に切り捨てられます。モデルごとの最大長:
string (任意)生成されたビデオから除外する要素。中国語と英語をサポートします。最大 500 文字。長いテキストは自動的に切り捨てられます。例:低解像度、エラー、最悪の品質、低品質、変形、余分な指、悪いプロポーション。audio_url string (任意)ビデオ生成用の音声ファイルの URL。サポートされているフォーマット:
| |||||||||||||||||||||||||
parameters object (任意)ビデオ生成パラメーター:解像度、プロンプトリライト、ウォーターマーク。
プロパティ resolution string (任意)生成されるビデオの解像度レベル。出力の鮮明さ (総ピクセル数) を制御します。
string (任意)出力ビデオのアスペクト比。
integer (任意)出力ビデオの持続時間 (秒)。
boolean (任意)プロンプトリライトを有効にします。有効にすると、LLM が入力プロンプトを書き換えて生成品質を向上させます。短いプロンプトに最適ですが、レイテンシが増加します。
boolean (任意)右下隅に「AI Generated」というテキストのウォーターマークを追加します。
integer (任意)乱数シードは [0, 2147483647] の範囲の整数である必要があります。指定しない場合、ランダムなシードが生成されます。固定シードは再現性を向上させます。モデルの生成は確率的であるため、同じシードが同一の結果を保証するわけではありません。 |
レスポンスパラメーター |
task_id を保存して、タスクのステータスと結果をクエリします。 |
output objectタスクの出力。
プロパティ task_id stringタスク ID。24 時間クエリに有効です。task_status stringタスクのステータス。
列挙値
| |
request_id stringトレースとトラブルシューティングのための一意のリクエスト識別子。 | |
code stringエラーコード。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。 | |
message string詳細なエラーメッセージ。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。 |
ステップ 2:結果のクエリ
- 北京
- シンガポール
GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/{task_id}- シンガポール
- 北京
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}{WorkspaceId} を実際のワークスペース ID に置き換えてください。
- ポーリングの推奨:ビデオ生成には数分かかります。15 秒などの適切な間隔でポーリングメカニズムを使用してください。
- タスクの状態遷移:PENDING → RUNNING → SUCCEEDED または FAILED。
- 結果リンク:タスクが成功した後、24 時間有効なビデオ URL が返されます。ビデオをダウンロードして、OSS などの永続ストレージに保存してください。
task_idの有効期間:24 時間。この期間が過ぎると、クエリはタスクのステータスをUNKNOWNとして返します。
リクエストパラメーター |
{task_id} を前の API 呼び出しで返された task_id の値に置き換えます。task_id は 24 時間クエリに有効です。{WorkspaceId} を実際のワークスペース ID に置き換えてください。 |
ヘッダー | |
Authorization string (必須)Model Studio API キーでリクエストを認証します。例:Bearer sk-xxxx。 | |
パスパラメーター | |
task_id string (必須)タスクの ID。 |
レスポンスパラメーター |
ビデオ URL は 24 時間のみ有効で、その後自動的に消去されます。生成されたビデオは速やかに保存してください。 |
outputobjectタスクの出力。
プロパティ task_id stringタスク ID。24 時間クエリに有効です。task_status stringタスクのステータス。
列挙値
stringタスクが送信された時刻。時刻は UTC+8 で、フォーマットは YYYY-MM-DD HH:mm:ss.SSS です。scheduled_time stringタスクが実行された時刻。時刻は UTC+8 で、フォーマットは YYYY-MM-DD HH:mm:ss.SSS です。end_time stringタスクが完了した時刻。時刻は UTC+8 で、フォーマットは YYYY-MM-DD HH:mm:ss.SSS です。video_url string生成されたビデオの URL。task_status が SUCCEEDED の場合にのみ返されます。24 時間有効です。ビデオは H.264 エンコーディングの MP4 フォーマットです。orig_prompt string元の入力プロンプト。リクエストパラメーター prompt に対応します。code stringエラーコード。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。message string詳細なエラーメッセージ。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。 | |
usage object出力統計。成功したタスクに対してのみ返されます。
プロパティ duration float課金に使用される総ビデオ持続時間。output_video_duration と等しい。input_video_duration integer固定値:0。output_video_duration integer出力ビデオの持続時間 (秒)。input.duration の値と一致します。SR integer出力ビデオの解像度レベル。例:720。ratio string出力ビデオのアスペクト比。例:16:9。video_count integer生成されたビデオの数。常に 1 です。 | |
request_id stringトレースとトラブルシューティングのための一意のリクエスト識別子。 |
HTTP (wan2.6 以前)
テキスト動画生成タスクには 1~5 分かかるため、API は非同期呼び出しを使用します:タスクを作成 → 結果をポーリング。
ステップ 1:タスクの作成
- シンガポール
- バージニア
- 北京
- フランクフルト
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis{WorkspaceId} を実際のワークスペース ID に置き換えてください。
- タスクが作成された後、返された
task_idを使用して結果をクエリします。task_idは 24 時間有効です。重複したタスクを作成しないでください。代わりに、ポーリングを使用して結果を取得してください。 - 初心者向けのガイダンスについては、「Postman または cURL で API を呼び出す」をご参照ください。
リクエストパラメーター |
|
リクエストヘッダー | |
Content-Type string (必須)リクエストのコンテンツタイプは application/json である必要があります。 | |
Authorization string (必須)Model Studio API キーでリクエストを認証します。例:Bearer sk-xxxx。 | |
X-DashScope-Async string (必須)非同期処理を有効にします。HTTP リクエストは非同期呼び出しのみをサポートします。enable に設定する必要があります。 | |
リクエストボディ | |
model string (必須)モデル名。モデルと料金については、「モデルの料金」をご参照ください。例:wan2.6-t2v。 | |
input object (必須)プロンプトを含む入力データ。
プロパティ prompt string (必須)ビデオのコンテンツと視覚スタイルを記述するテキストプロンプト。中国語と英語をサポートします。各文字または手紙は 1 つとしてカウントされます。制限を超えるテキストは自動的に切り捨てられます。モデルごとの最大長:
string (任意)生成されたビデオから除外する要素。中国語と英語をサポートします。最大 500 文字。長いテキストは自動的に切り捨てられます。例:低解像度、エラー、最悪の品質、低品質、変形、余分な指、悪いプロポーション。audio_url string (任意)サポートされているモデル:wan2.6 および wan2.5 シリーズ。ビデオ生成用の音声ファイルの URL。サポートされているフォーマット:
| |
parameters object (任意)ビデオ生成パラメーター:解像度、プロンプトリライト、ウォーターマーク。
プロパティ size string (任意)出力ビデオの解像度を 幅*高さ 形式で指定します。デフォルト値と有効な値はモデルによって異なります:
integer (任意)出力ビデオの持続時間 (秒)。有効な値はモデルによって異なります:
boolean (任意)プロンプトリライトを有効にします。有効にすると、LLM が入力プロンプトを書き換えて品質を向上させます。短いプロンプトに最適ですが、レイテンシが増加します。
string (任意)サポートされているモデル:wan2.6 モデル。出力ビデオのショット構造:1 つの連続したショットまたはトランジション付きの複数のショット。有効な値:
"prompt_extend": true が設定されている場合にのみ有効です。優先度:shot_type はプロンプトをオーバーライドします。shot_type を single に設定すると、プロンプトがマルチショットを要求していてもシングルショットビデオが生成されます。watermark boolean (任意)右下隅に「AI Generated」というテキストのウォーターマークを追加します。
integer (任意)乱数シードは [0, 2147483647] の範囲の整数である必要があります。指定しない場合、ランダムなシードが生成されます。固定シードは再現性を向上させます。モデルの生成は確率的であるため、同じシードが同一の結果を保証するわけではありません。 |
レスポンスパラメーター |
task_id を保存して、タスクのステータスと結果をクエリします。 |
output objectタスクの出力。
プロパティ task_id stringタスク ID。24 時間クエリに有効です。task_status stringタスクのステータス。
列挙値
| |
request_id stringトレースとトラブルシューティングのための一意のリクエスト識別子。 | |
code stringエラーコード。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。 | |
message string詳細なエラーメッセージ。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。 |
ステップ 2:結果のクエリ
- シンガポール
- バージニア
- 北京
- フランクフルト
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}{WorkspaceId} を実際のワークスペース ID に置き換えてください。
- ポーリングの推奨:ビデオ生成には数分かかります。15 秒などの適切な間隔でポーリングメカニズムを使用してください。
- タスクの状態遷移:PENDING → RUNNING → SUCCEEDED または FAILED。
- 結果リンク:タスクが成功した後、24 時間有効なビデオ URL が返されます。ビデオをダウンロードして、OSS などの永続ストレージに保存してください。
task_idの有効期間:24 時間。この期間が過ぎると、クエリはタスクのステータスをUNKNOWNとして返します。
リクエストパラメーター |
{task_id} を前の API 呼び出しで返された task_id の値に置き換えます。task_id は 24 時間クエリに有効です。{WorkspaceId} を実際のワークスペース ID に置き換えてください。 |
ヘッダー | |
Authorization string (必須)Model Studio API キーでリクエストを認証します。例:Bearer sk-xxxx。 | |
パスパラメーター | |
task_id string (必須)タスクの ID。 |
レスポンスパラメーター |
ビデオ URL は 24 時間のみ有効で、その後自動的に消去されます。生成されたビデオは速やかに保存してください。 |
outputobjectタスクの出力。
プロパティ task_id stringタスク ID。24 時間クエリに有効です。task_status stringタスクのステータス。
列挙値
stringタスクが送信された時刻。時刻は UTC+8 で、フォーマットは YYYY-MM-DD HH:mm:ss.SSS です。scheduled_time stringタスクが実行された時刻。時刻は UTC+8 で、フォーマットは YYYY-MM-DD HH:mm:ss.SSS です。end_time stringタスクが完了した時刻。時刻は UTC+8 で、フォーマットは YYYY-MM-DD HH:mm:ss.SSS です。video_url string生成されたビデオの URL。task_status が SUCCEEDED の場合にのみ返されます。24 時間有効です。ビデオは H.264 エンコーディングの MP4 フォーマットです。orig_prompt string元の入力プロンプト。リクエストパラメーター prompt に対応します。actual_prompt stringprompt_extend=true の場合、システムは入力プロンプトを書き換えます。このフィールドには、生成に使用された書き換え後のプロンプトが含まれます。
stringエラーコード。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。message string詳細なエラーメッセージ。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。 | |
usage object出力統計。成功したタスクに対してのみ返されます。
プロパティ video_duration integerwan2.5 以前でのみ返されます (課金に使用)。出力ビデオの持続時間 (秒)。有効な値:5, 10。duration floatwan2.6 でのみ返されます (課金に使用)。総ビデオ持続時間。式:duration=input_video_duration+output_video_duration。input_video_duration integerwan2.6 でのみ返されます。固定値:0。output_video_duration integerwan2.6 でのみ返されます。出力ビデオの持続時間 (秒)。input.duration の値と一致します。SR integerwan2.6 でのみ返されます。出力ビデオの解像度レベル。例:720。size stringwan2.6 でのみ返されます。出力解像度を「幅×高さ」形式で指定します。例:1920×1080。video_ratio stringwan2.5 以前でのみ返されます。出力解像度を「幅×高さ」形式で指定します。例:832×480。video_count integer生成されたビデオの数。常に 1 です。 | |
request_id stringトレースとトラブルシューティングのための一意のリクエスト識別子。 |
DashScope SDK
SDK のパラメーター名は、ほとんどが HTTP API と一致しており、構造は言語固有の規則に従います。
テキスト動画生成タスクには 1~5 分かかります。SDK は非同期 HTTP 呼び出しフローをラップし、同期および非同期の両方の呼び出しをサポートします。
実際の処理時間は、キューの深さとサービスの負荷によって異なります。
Python SDK
モデルが属するリージョンに基づいて region を設定します(Client の構築時に渡します。region の値はリージョンによって異なります):
- 北京
- シンガポール
- バージニア
region="cn-beijing"{WorkspaceId} を実際のワークスペース ID に置き換えてください。
- 同期呼び出し
- 非同期呼び出し
リクエスト例
レスポンス例
video_url は 24 時間後に有効期限が切れます。速やかにダウンロードしてください。
Java SDK
Constants.baseHttpApiUrl をリージョンエンドポイントに設定します:
- シンガポール
- バージニア
- 北京
Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";{WorkspaceId} を実際のワークスペース ID に置き換えてください。
- 同期呼び出し
- 非同期呼び出し
リクエスト例
レスポンス例
video_url は 24 時間後に有効期限が切れます。速やかにダウンロードしてください。
制限事項
- データ保持:タスク ID (
task_id) とビデオ URL (video_url) は 24 時間後に有効期限が切れます。有効期限が切れると、クエリやダウンロードはできなくなります。 - コンテンツモデレーション:入力と出力はコンテンツモデレーションの対象となります。禁止されたコンテンツは「IPInfringementSuspect」または「DataInspectionFailed」エラーをトリガーします。「エラーコード」をご参照ください。
エラーコード
モデルの呼び出しが失敗し、エラーメッセージが返された場合は、「エラーコード」で解決策をご確認ください。
よくある質問
Q:wan2.6 から wan2.7 にアップグレードするために必要なコードの変更点は何ですか?
A:2 つの変更が必要です:
- 解像度制御:wan2.7 は
sizeフィールドを置き換えます。代わりに、resolution(解像度レベル) とratio(アスペクト比) の組み合わせを使用して出力解像度を定義します。以前のモデルではsizeフィールドが使用されていました。 - ショットタイプの削除:wan2.7 は
shot_typeフィールドを廃止しました。代わりに、プロンプトで直接ショット構造を記述します。
Q:一時的なビデオリンクを永続的なものに変換するにはどうすればよいですか?
A:直接の変換はできません。URL からビデオをダウンロードし、それを永続ストレージ (Alibaba Cloud OSS など) にアップロードして永続的なリンクを生成してください。
サンプルコード:ビデオをローカルデバイスにダウンロードする
サンプルコード:ビデオをローカルデバイスにダウンロードする