PixVerse のテキストから動画を生成するモデルは、テキストプロンプトに基づいて滑らかな動画を生成します。
サービスの有効化
- Model Studio コンソールに移動し、PixVerse を検索して PixVerse のモデルカードを見つけ、今すぐ有効化をクリックします。
- ポップアップウィンドウで、有効化と権限付与を確認します。
使用上の注意
API 呼び出しを成功させるには、モデル、エンドポイント URL、API キーを同じリージョンのものに統一する必要があります。リージョンをまたぐ呼び出しは失敗します。
- モデルの選択: モデルのリージョンを確認します。
- URL の選択: 対応するリージョンのエンドポイント URL を選択します。HTTP と DashScope SDK の両方の URL に対応しています。
- 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 (必須)モデル名です。有効な値:
object (必須)プロンプトなどの基本入力情報です。
プロパティ prompt string (必須)テキストプロンプトです。生成する動画に含めたい要素や視覚的な特徴を説明します。中国語と英語に対応しています。中国語の文字と英字はいずれも 1 文字として数えます。文字エンコーディングは UTF-8 です。上限を超える文字は自動的に切り詰められます。
object (必須)動画の解像度、長さ、音声を生成するかどうかなど、動画生成のパラメーターです。
プロパティ size string (必須)生成する動画の解像度です。width*height の形式でピクセル単位で指定します。次の表に、解像度区分とアスペクト比ごとの有効な値を示します。
pixverse/pixverse-v6-t2v モデル
integer (必須)生成する動画の長さ(秒)です。
boolean (任意)音声付き動画を生成するかどうかを指定します。有効にすると、モデルは動画の内容に合った BGM や効果音を自動的に生成します。
boolean (任意)ウォーターマークを追加するかどうかを指定します。動画の右下に、固定テキスト「AI Generated」のウォーターマークが表示されます。
string (任意)対応モデル: pixverse/pixverse-v6-t2v.生成する動画のショットタイプを指定します。動画を 1 つの連続したショットで構成するか、複数のショットで構成するかを制御します。
integer (任意)乱数シードは [0, 2147483647] の範囲の整数である必要があります。省略するとランダムなシードが生成されます。固定シードを使用すると再現性が向上します。モデルの生成は確率的であるため、同じシードでも同一の結果は保証されません。 |
対応モデル: pixverse/pixverse-v6-t2v. |
レスポンスパラメーター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}
- ポーリングの推奨事項: 動画の生成には数分かかる場合があります。ポーリング方式を使用し、15 秒ごとなど適切な間隔で結果をポーリングしてください。
- タスク状態の遷移: PENDING(待機中)→ RUNNING(処理中)→ SUCCEEDED(成功)/ FAILED(失敗)。
- タスク ID の有効期間:
task_idは24 時間有効です。有効期限が切れると照会は失敗し、API はタスク状態UNKNOWNを返します。 - RPS 制限: 照会エンドポイントのデフォルトの制限は 20 RPS です。高頻度の照会やイベント通知には、非同期タスクのコールバックを設定してください。
- その他の操作: 一括照会、タスクのキャンセルなどの操作については、非同期タスクの管理を参照してください。
リクエストパラメーターリクエストヘッダーAuthorizationstring (必須)Model Studio の API キーでリクエストを認証します。例:Bearer sk-xxxx。パスパラメーターtask_idstring (必須)タスクの ID です。 |
{task_id} を前の API 呼び出しで返された task_id の値に置き換えます。task_id は 24 時間以内の照会に使用できます。{WorkspaceId} を実際のワークスペース ID に置き換えてください。 |
レスポンスパラメーターoutputobjectタスクの出力情報です。
プロパティ task_id stringタスク ID です。24 時間以内の照会に使用できます。task_status stringタスクの状態です。
列挙値
stringタスクの送信時刻です。形式は YYYY-MM-DD HH:mm:ss.SSS です。scheduled_time stringタスクの実行時刻です。形式は YYYY-MM-DD HH:mm:ss.SSS です。end_time stringタスクの完了時刻です。形式は YYYY-MM-DD HH:mm:ss.SSS です。video_url string動画の URL です。task_status が SUCCEEDED の場合のみ返されます。動画の形式は MP4(H.264 エンコーディング)です。動画リンクは現在のところ有効期限がありませんが、長期保存を目的としたものではありません。速やかにダウンロードしてください。orig_prompt string入力された元のプロンプトです。リクエストパラメーター prompt に対応します。code stringエラーコードです。リクエストが失敗した場合のみ返されます。エラーコードを参照してください。message string詳細なエラーメッセージです。リクエストが失敗した場合のみ返されます。エラーコードを参照してください。object出力の使用量統計です。成功したタスクのみが集計対象です。
プロパティ duration integer生成された動画の合計時間(秒)です。課金に使用されます。size string生成された動画の解像度です。fps integer生成された動画のフレームレートです。SR string生成された動画の解像度区分です。audio boolean生成された動画に音声が含まれるかどうかを示します。video_count integer生成された動画の数です。1 に固定されています。shot_type string生成された動画のショットタイプです。string追跡とトラブルシューティングに使用する一意のリクエスト識別子です。 |
|
DashScope SDK 呼び出し
SDK のパラメーター名は HTTP API とほぼ一致しています。パラメーター構造は各プログラミング言語の特性に合わせて調整されています。
テキストからの動画生成タスクには時間がかかる(通常 1~5 分)ため、SDK は HTTP の非同期呼び出しプロセスをカプセル化しており、同期呼び出しと非同期呼び出しの両方に対応しています。
実際の所要時間は、待機中のタスク数とサービスの実行状況によって異なります。結果が返されるまでしばらくお待ちください。
Python SDK 呼び出し
シンガポールリージョン: region="ap-southeast-1"
{WorkspaceId} を実際のワークスペース ID に置き換えてください。
- 同期呼び出し
- 非同期呼び出し
リクエスト例
レスポンス例
video_url は現在のところ有効期限がありませんが、長期保存を目的としたものではありません。速やかに動画をダウンロードしてください。
Java SDK 呼び出し
シンガポールリージョン: Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
{WorkspaceId} を実際のワークスペース ID に置き換えてください。
- 同期呼び出し
- 非同期呼び出し
リクエスト例
レスポンス例
video_url は現在のところ有効期限がありませんが、長期保存を目的としたものではありません。速やかに動画をダウンロードしてください。