Wan テキスト動画生成モデルは、 テキストプロンプト からスムーズな動画を生成します。
リファレンス: ユーザーガイド
呼び出しを成功させるには、モデル、エンドポイント URL、API キーがすべて同じリージョンに属している必要があります。リージョン間の呼び出しは失敗します。
テキスト動画生成タスクは時間がかかるため (通常 1〜5 分)、API は非同期呼び出しを使用します。プロセス全体には、タスクの作成 -> 結果のポーリングという 2 つのコアステップが含まれます。プロセスは次のとおりです:
SDK のパラメーター名は、ほとんどが HTTP API と一致しており、パラメーター構造はプログラミング言語の機能に合わせてカプセル化されています。
テキスト動画生成タスクは完了までに時間がかかるため (通常 1〜5 分)、SDK は HTTP 非同期呼び出しプロセスをカプセル化し、同期と非同期の両方の呼び出しメソッドをサポートしています。
モデルのリージョンに応じて
モデルが配置されているリージョンに基づいて
モデルの呼び出しが失敗し、エラーメッセージが返された場合は、「エラーコード」で解決策をご参照ください。
A:リンクを直接変換することはできません。正しい手順は、バックエンドサービスで URL を取得し、動画ファイルをダウンロードしてから、Alibaba Cloud Object Storage Service (OSS) などの永続的なオブジェクトストレージサービスにアップロードして、新しい永続的なアクセスリンクを生成することです。
A:いいえ。リンクは 24 時間後に期限切れになるため、ブラウザで直接再生しないでください。代わりに、動画をダウンロードして保存し、再生には永続的なリンクを使用してください。
利用可能リージョン
呼び出しを成功させるには、モデル、エンドポイント URL、API キーがすべて同じリージョンに属している必要があります。リージョン間の呼び出しは失敗します。
- モデルの選択:モデルのリージョンを確認します。
- URL の選択:対応するリージョンのエンドポイント URL を選択します。HTTP URL と DashScope SDK URL がサポートされています。
- API キーの設定:リージョンを選択し、API キーを取得してから、API キーを環境変数として設定します (非推奨となり、API キー設定に統合される予定です)。
- SDK のインストール:SDK を使用して呼び出しを行うには、DashScope SDK をインストールする必要があります。
このトピックのサンプルコードは、シンガポールリージョンに適用されます。
HTTP
テキスト動画生成タスクは時間がかかるため (通常 1〜5 分)、API は非同期呼び出しを使用します。プロセス全体には、タスクの作成 -> 結果のポーリングという 2 つのコアステップが含まれます。プロセスは次のとおりです:
ステップ 1:タスクを作成し、タスク ID を取得する
- シンガポール
- 米国 (バージニア)
- フランクフルト
- 北京
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-Typestring (必須)リクエストのコンテンツタイプです。application/json である必要があります。Authorization string (必須)Model Studio API キーでリクエストを認証します。例:Bearer sk-xxxx。X-DashScope-Async string (必須)非同期処理を有効にします。HTTP リクエストは非同期呼び出しのみをサポートします。enable である必要があります。リクエストボディmodelstring (必須)使用するモデルの名前です。利用可能なモデルのリストについては、「モデルリスト」をご参照ください。例:wan2.6-t2v。input object (必須)プロンプトなどの基本的な入力情報を含みます。
プロパティ prompt string (必須)テキストプロンプトです。生成される動画の望ましい要素と視覚的特徴を記述します。プロンプトは中国語または英語で指定できます。長さは文字数で測定され、各漢字またはアルファベットは 1 文字としてカウントされます。文字数制限を超えたテキストは自動的に切り捨てられます。文字数制限はモデルのバージョンによって異なります:
string (任意)動画から除外するコンテンツを記述するプロンプトです。これにより、生成されるコンテンツを洗練させることができます。プロンプトは中国語または英語で指定できます。最大長は 500 文字です。この制限を超えたテキストは自動的に切り捨てられます。例:低解像度、エラー、最低品質、低品質、変形、余分な指、悪いプロポーション。audio_url string (任意)サポートされているモデル:wan2.6 および wan2.5 シリーズモデル。音声ファイルの URL です。モデルはこの音声を使用して動画を生成します。サポートされている入力フォーマット:
object (任意)動画の解像度の設定、プロンプトリライトの有効化、ウォーターマークの追加など、動画処理パラメーターです。
プロパティ size string (任意)生成される動画の解像度を 幅*高さ のフォーマットで指定します。このパラメーターのデフォルト値と有効な値は、以下のように model パラメーターに依存します:
integer (任意)生成される動画の持続時間 (秒単位)。このパラメーターの有効な値は、model パラメーターに依存します:
boolean (任意)プロンプトリライトを有効にするかどうかを指定します。有効にすると、モデルは入力プロンプトをインテリジェントに書き換えます。これにより、短いプロンプトで生成される動画の品質が大幅に向上しますが、実行時間は長くなります。
string (任意)サポートされているモデル:wan2.6 モデル。生成される動画のショットタイプ、つまり動画が単一の連続したショットで構成されるか、複数の変化するショットで構成されるかを指定します。有効な値:
"prompt_extend": true が設定されている場合にのみ有効です。パラメーターの優先度:shot_type > prompt。たとえば、shot_type が "single" に設定されている場合、プロンプトに "generate a multi-shot video" が含まれていても、モデルはシングルショット動画を出力します。watermark boolean (任意)ウォーターマークを追加するかどうかを指定します。ウォーターマークは動画の右下隅に配置され、固定テキスト「AI Generated」が表示されます。
integer (任意)乱数シードは、[0, 2147483647] の範囲の整数である必要があります。指定しない場合、ランダムなシードが生成されます。固定シードは再現性を向上させます。モデルの生成は確率的であるため、同じシードでも同一の結果が保証されるわけではありません。 |
|
レスポンスパラメーターoutputobjectタスクの出力情報を含みます。
プロパティ task_id stringタスク ID です。24 時間クエリに有効です。task_status stringタスクのステータスです。
列挙値
stringトレースとトラブルシューティングのための一意のリクエスト識別子です。code stringエラーコードです。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。message string詳細なエラーメッセージです。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。 |
task_id を保存して、タスクのステータスと結果をクエリします。 |
ステップ 2:タスク 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として返します。
リクエストパラメーターリクエストヘッダーAuthorizationstring (必須)Model Studio API キーでリクエストを認証します。例:Bearer sk-xxxx。URL パスパラメーターtask_idstring (必須)タスクの ID です。 |
{task_id} を、前の API 呼び出しで返された task_id の値に置き換えてください。task_id は 24 時間クエリに有効です。{WorkspaceId} を実際のワークスペース ID に置き換えてください。 |
レスポンスパラメーター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 時間有効です。動画は MP4 フォーマットで H.264 エンコーディングです。orig_prompt string元の入力プロンプトで、リクエストパラメーター prompt に対応します。actual_prompt stringprompt_extend=true の場合、システムは入力プロンプトを書き換えます。このフィールドは、生成に使用された最適化されたプロンプトを返します。
stringエラーコードです。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。message string詳細なエラーメッセージです。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。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 モデルを使用している場合にのみ返されます。生成された動画の解像度です。フォーマットは「幅高さ」です。例:19201080。video_ratio stringwan2.5 およびそれ以前のモデルを使用している場合にのみ返されます。生成された動画の解像度です。フォーマットは「幅高さ」です。例:832480。video_count integer生成された動画の数です。1 に固定されています。stringトレースとトラブルシューティングのための一意のリクエスト識別子です。 |
動画 URL は 24 時間のみ有効で、その後自動的にパージされます。生成された動画は速やかに保存してください。 |
DashScope SDK
SDK のパラメーター名は、ほとんどが HTTP API と一致しており、パラメーター構造はプログラミング言語の機能に合わせてカプセル化されています。
テキスト動画生成タスクは完了までに時間がかかるため (通常 1〜5 分)、SDK は HTTP 非同期呼び出しプロセスをカプセル化し、同期と非同期の両方の呼び出しメソッドをサポートしています。
実際の処理時間は、キュー内のタスク数とサービスステータスによって異なります。結果をお待ちください。
Python
モデルのリージョンに応じて region を設定します(Client 構築時に渡します。リージョンによって region の値は異なります):
- シンガポール
- バージニア
- 北京
- フランクフルト
region="ap-southeast-1"{WorkspaceId} を実際のワークスペース ID に置き換えてください。- 同期呼び出し
- 非同期呼び出し
リクエストの例
レスポンスの例
video_url は 24 時間有効です。速やかにダウンロードしてください。
Java
モデルが配置されているリージョンに基づいて Constants.baseHttpApiUrl を設定します:
- シンガポール
- バージニア
- 北京
- フランクフルト
Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";{WorkspaceId} を実際のワークスペース ID に置き換えてください。- 同期呼び出し
- 非同期呼び出し
リクエストの例
レスポンスの例
video_url は 24 時間有効です。速やかにダウンロードしてください。
エラーコード
モデルの呼び出しが失敗し、エラーメッセージが返された場合は、「エラーコード」で解決策をご参照ください。
よくある質問
Q:一時的な動画リンクを永続的なリンクに変換するにはどうすればよいですか?
A:リンクを直接変換することはできません。正しい手順は、バックエンドサービスで URL を取得し、動画ファイルをダウンロードしてから、Alibaba Cloud Object Storage Service (OSS) などの永続的なオブジェクトストレージサービスにアップロードして、新しい永続的なアクセスリンクを生成することです。
コード例:動画をローカルデバイスにダウンロードする
コード例:動画をローカルデバイスにダウンロードする