Skip to main content

PixVerse - 最初と最後のフレームから動画生成 API リファレンス

PixVerse の最初と最後のフレームから動画を生成するモデルは、最初のフレーム画像、最後のフレーム画像、テキストプロンプトに基づいて、滑らかに遷移する動画を生成します。

このドキュメントはシンガポールリージョンにのみ適用されます。このリージョンの API キーを使用する必要があります。

サービスの有効化

  1. Model Studio コンソールに移動し、PixVerse を検索して PixVerse のモデルカードを見つけ、今すぐ有効化をクリックします。
  2. ポップアップウィンドウで、有効化と権限付与を確認します。

使用上の注意

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-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 (必須)モデル名です。有効な値:
  • pixverse/pixverse-v6-kf2v
input object (必須)最初のフレーム画像、最後のフレーム画像、プロンプトを含む基本入力情報です。

プロパティ

prompt string (必須)テキストプロンプトです。最初のフレームから最後のフレームへの遷移プロセスを説明します。中国語と英語に対応しています。中国語の文字と英字はいずれも 1 文字として数えます。文字エンコーディングは UTF-8 です。上限を超える文字は自動的に切り詰められます。
  • pixverse/pixverse-v6-kf2v: 最大 5,000 文字です。
media array (必須)最初のフレーム画像と最後のフレーム画像を含むメディアリソースのリストです。配列の各要素は、type フィールドと url フィールドを含むメディアオブジェクトです。

プロパティ

type string (必須)メディアの種類です。
  • first_frame: 最初のフレーム画像。
  • last_frame: 最後のフレーム画像。
素材の制限:
  • 最初のフレーム画像:ちょうど 1 枚。
  • 最後のフレーム画像:ちょうど 1 枚。
url string (必須)パブリックにアクセスできる画像の URL です。画像の制限:
  • 形式:JPG、PNG、WEBP。
  • 解像度:幅と高さはいずれも 10,000 ピクセルを超えることはできません。
  • ファイルサイズ:最大 20 MB。
parameters object (必須)動画の解像度、長さ、音声を生成するかどうかなど、動画生成のパラメーターです。

プロパティ

resolution string (必須)
resolution パラメーターは料金に直接影響します。呼び出し前にモデル料金を確認してください。
生成する動画の解像度です。有効な値:360P、540P、720P、1080P。duration integer (必須)
duration パラメーターは料金に直接影響します。呼び出し前にモデル料金を確認してください。
生成する動画の長さ(秒)です。
  • pixverse/pixverse-v6-kf2v: [1, 15] の範囲の整数です。
audio boolean (任意)
audio パラメーターは料金に直接影響します。呼び出し前にモデル料金を確認してください。
音声付き動画を生成するかどうかを指定します。有効にすると、モデルは動画の内容に合った BGM や効果音を自動的に生成します。
  • false: デフォルト値。無音動画を出力します。
  • true: 音声付き動画を出力します。
watermark boolean (任意)ウォーターマークを追加するかどうかを指定します。動画の右下に、固定テキスト「AI Generated」のウォーターマークが表示されます。
  • false: デフォルト値。ウォーターマークを追加しません。
  • true: ウォーターマークを追加します。
seed integer (任意)乱数シードは [0, 2147483647] の範囲の整数である必要があります。省略するとランダムなシードが生成されます。固定シードを使用すると再現性が向上します。モデルの生成は確率的であるため、同じシードでも同一の結果は保証されません。
  • 最初と最後のフレームから動画生成
  • Python SDK
対応モデル: pixverse/pixverse-v6-kf2v.
# {WorkspaceId} を実際のワークスペース ID に置き換えてください。
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.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": "pixverse/pixverse-v6-kf2v",
    "input": {
        "media": [
            {
                "type": "first_frame",
                "url": "https://wanx.alicdn.com/material/20250318/first_frame.png"
            },
            {
                "type": "last_frame",
                "url": "https://wanx.alicdn.com/material/20250318/last_frame.png"
            }
        ],
        "prompt": "A kitten jumps down from the windowsill, lands lightly on the sofa, and then looks around curiously."
    },
    "parameters": {
        "resolution": "720P",
        "duration": 5,
        "watermark": true
    }
}'

レスポンスパラメーター

output objectタスクの出力情報です。

プロパティ

task_id stringタスク ID です。24 時間以内の照会に使用できます。task_status stringタスクの状態です。

列挙値

  • PENDING:タスクは待機中です。
  • RUNNING:タスクは処理中です。
  • SUCCEEDED:タスクは成功しました。
  • FAILED:タスクは失敗しました。
  • CANCELED:タスクはキャンセルされました。
  • UNKNOWN:タスクが存在しないか、状態が不明です。
request_id string追跡とトラブルシューティングに使用する一意のリクエスト識別子です。code stringエラーコードです。リクエストが失敗した場合のみ返されます。エラーコードを参照してください。message string詳細なエラーメッセージです。リクエストが失敗した場合のみ返されます。エラーコードを参照してください。
  • 成功レスポンス
  • エラーレスポンス
タスクの状態と結果を照会できるよう、task_id を保存してください。
{
    "output": {
        "task_status": "PENDING",
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
    },
    "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

ステップ 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 です。高頻度の照会やイベント通知には、非同期タスクのコールバックを設定してください。
  • その他の操作: 一括照会、タスクのキャンセルなどの操作については、非同期タスクの管理を参照してください。

リクエストパラメーター

リクエストヘッダー
Authorization string (必須)Model Studio の API キーでリクエストを認証します。例:Bearer sk-xxxx。
パスパラメーター
task_id string (必須)タスクの ID です。
  • タスク結果の照会
{task_id} を前の API 呼び出しで返された task_id の値に置き換えます。task_id は 24 時間以内の照会に使用できます。{WorkspaceId} を実際のワークスペース ID に置き換えてください。
curl -X GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

レスポンスパラメーター

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 の場合は、エラーメッセージを確認して再試行してください。
  • 状態が CANCELED の場合、タスクはキャンセルされています。続行するには、タスクを再送信してください。
  • 状態が UNKNOWN の場合、タスクが存在しないか、状態が不明です。task_id が存在しない場合や、24 時間の有効期間を過ぎた場合に発生することがあります。
submit_time 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詳細なエラーメッセージです。リクエストが失敗した場合のみ返されます。エラーコードを参照してください。
usage object出力の使用量統計です。成功したタスクのみが集計対象です。

プロパティ

duration integer生成された動画の合計時間です。課金に使用されます。size string生成された動画の解像度です。fps integer生成された動画のフレームレートです。SR string生成された動画の解像度区分です。audio boolean生成された動画に音声が含まれるかどうかを示します。video_count integer生成された動画の数です。1 に固定されています。
request_id string追跡とトラブルシューティングに使用する一意のリクエスト識別子です。
  • タスク成功
  • タスク失敗
  • タスク照会の有効期限切れ
{
    "request_id": "40799260-689c-4c44-9d7c-xxxxxx",
    "output": {
        "task_id": "408b6c3b-27c9-43dd-b928-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2026-03-20 13:47:42.916",
        "scheduled_time": "2026-03-20 13:47:42.949",
        "end_time": "2026-03-20 13:48:41.896",
        "orig_prompt": "A kitten jumps down from the windowsill, lands lightly on the sofa, and then looks around curiously.",
        "video_url": "https://media.pixverseai.cn/xxx.mp4"
    },
    "usage": {
        "duration": 5,
        "size": "1280*960",
        "fps": 24,
        "video_count": 1,
        "audio": false,
        "SR": "720"
    }
}

エラーコード

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

よくある質問

Q:media 配列内の最初のフレームと最後のフレームに順序の決まりはありますか。

A:media 配列には 2 つのオブジェクトを含める必要があり、type にはそれぞれ first_frame(最初のフレーム)と last_frame(最後のフレーム)を設定します。順序は結果に影響しません。システムは type フィールドに基づいて各画像を自動的に識別します。

Q:最初のフレーム画像と最後のフレーム画像の解像度を同じにする必要がありますか。

A:いいえ。最初のフレーム画像と最後のフレーム画像の解像度は異なっていてもかまいません。システムが自動的に処理します。 出力動画のアスペクト比は、おおむね最初のフレーム画像に従います。解像度は、選択した resolution の区分(720P など)に基づいて、近い総画素数に自動的に調整されます。