PixVerse の画像から動画を生成するモデルは、入力画像とテキストプロンプトから滑らかな動画を生成します。
サービスの有効化
- Model Studio コンソールに移動し、PixVerse を検索して PixVerse のモデルカードを見つけ、今すぐ有効化をクリックします。
- ポップアップウィンドウで、有効化と権限付与を確認します。
使用上の注意
API 呼び出しを成功させるには、モデル、エンドポイント URL、API キーを同じリージョンのものに統一する必要があります。リージョンをまたぐ呼び出しは失敗します。
- モデルの選択: モデルのリージョンを確認します。
- URL の選択: 対応するリージョンのエンドポイント URL を選択します。HTTP と DashScope SDK の両方の URL に対応しています。
- API キーの設定: リージョンの API キーを取得してから、API キーを環境変数に設定します。
このページのサンプルコードはシンガポールリージョンに適用されます。
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 です。上限を超える文字は自動的に切り詰められます。
array (必須)動画生成に必要な画像を指定するメディア素材のリストです。配列の各要素は、type フィールドと url フィールドを含むメディアオブジェクトです。
プロパティ type string (必須)メディア素材の種類です。固定値:
複数の画像を指定した場合、システムはデフォルトで最後の画像を使用します。期待どおりの結果を得るため、常に画像を 1 枚だけ指定してください。url string (必須)画像ファイルの URL です。パブリックにアクセスできる必要があります。
object (必須)動画の解像度、動画の長さ、音声の生成、ウォーターマークなど、動画処理のパラメーターです。
プロパティ resolution string (必須)生成する動画の解像度区分を指定します。有効な値:360P、540P、720P、1080P。duration integer (必須)生成する動画の長さ(秒)です。
boolean (任意)音声付き動画を生成するかどうかを指定します。有効にすると、モデルは動画の内容に合った BGM や効果音を自動的に生成します。
boolean (任意)ウォーターマークを追加するかどうかを指定します。動画の右下に、固定テキスト「AI Generated」のウォーターマークが表示されます。
string (任意)対応モデル: pixverse/pixverse-v6-it2v.生成する動画のショットタイプを指定します。動画を 1 つの連続したショットで構成するか、複数のショットで構成するかを制御します。
integer (任意)乱数シードは [0, 2147483647] の範囲の整数である必要があります。省略するとランダムなシードが生成されます。固定シードを使用すると再現性が向上します。モデルの生成は確率的であるため、同じシードでも同一の結果は保証されません。 |
対応モデル: pixverse/pixverse-v6-it2v. |
レスポンスパラメーター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追跡とトラブルシューティングに使用する一意のリクエスト識別子です。 |
|