Skip to main content

PixVerse - テキストから動画生成 API リファレンス

PixVerse のテキストから動画を生成するモデルは、テキストプロンプトに基づいて滑らかな動画を生成します。

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

サービスの有効化

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

使用上の注意

API 呼び出しを成功させるには、モデル、エンドポイント URL、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-t2v
input object (必須)プロンプトなどの基本入力情報です。

プロパティ

prompt string (必須)テキストプロンプトです。生成する動画に含めたい要素や視覚的な特徴を説明します。中国語と英語に対応しています。中国語の文字と英字はいずれも 1 文字として数えます。文字エンコーディングは UTF-8 です。上限を超える文字は自動的に切り詰められます。
  • pixverse/pixverse-v6-t2v: 最大 5,000 文字です。
parameters object (必須)動画の解像度、長さ、音声を生成するかどうかなど、動画生成のパラメーターです。

プロパティ

size string (必須)生成する動画の解像度です。width*height の形式でピクセル単位で指定します。
size パラメーターは料金に直接影響します。呼び出し前にモデル料金を確認してください。
次の表に、解像度区分とアスペクト比ごとの有効な値を示します。

pixverse/pixverse-v6-t2v モデル

解像度区分

アスペクト比

size の値(width*height)

360P

16:9

640*360

4:3

640*480

1:1

640*640

3:4

480*640

9:16

360*640

3:2

640*432

2:3

432*640

21:9

640*288

540P

16:9

1024*576

4:3

1024*768

1:1

1024*1024

3:4

768*1024

9:16

576*1024

3:2

1024*688

2:3

688*1024

21:9

1024*448

720P

16:9

1280*720

4:3

1108*832

1:1

960*960

3:4

832*1108

9:16

720*1280

3:2

1200*800

2:3

800*1200

21:9

1280*560

1080P

16:9

1920*1080

4:3

1664*1248

1:1

1440*1440

3:4

1248*1664

9:16

1080*1920

3:2

1776*1184

2:3

1184*1776

21:9

1920*832

duration integer (必須)
duration パラメーターは、秒単位で課金される料金に直接影響します。呼び出し前にモデル料金を確認してください。
生成する動画の長さ(秒)です。
  • pixverse/pixverse-v6-t2v: [1, 15] の範囲の整数です。
audio boolean (任意)
audio パラメーターは料金に直接影響します。呼び出し前にモデル料金を確認してください。
音声付き動画を生成するかどうかを指定します。有効にすると、モデルは動画の内容に合った BGM や効果音を自動的に生成します。
  • false: デフォルト値。無音動画を出力します。
  • true: 音声付き動画を出力します。
watermark boolean (任意)ウォーターマークを追加するかどうかを指定します。動画の右下に、固定テキスト「AI Generated」のウォーターマークが表示されます。
  • false: デフォルト値。ウォーターマークを追加しません。
  • true: ウォーターマークを追加します。
shot_type string (任意)対応モデル: pixverse/pixverse-v6-t2v.生成する動画のショットタイプを指定します。動画を 1 つの連続したショットで構成するか、複数のショットで構成するかを制御します。
  • single: デフォルト値。シングルショットの動画を生成します。
  • multi: マルチショット。システムがショットをインテリジェントに分割します。
使用上の推奨事項:prompt パラメーターは shot_type よりも優先度が高くなります。最適な結果を得るには、このパラメーターの設定をプロンプトの説明と一致させることを推奨します。
  • シングルショットの動画を安定して出力する場合:shot_type="single" を設定し、プロンプトでシングルショットのシーンを説明します。
  • マルチショットの動画を安定して出力する場合:shot_type="multi" を設定し、プロンプトでマルチショットのシーンを説明します。
seed integer (任意)乱数シードは [0, 2147483647] の範囲の整数である必要があります。省略するとランダムなシードが生成されます。固定シードを使用すると再現性が向上します。モデルの生成は確率的であるため、同じシードでも同一の結果は保証されません。
  • テキストから動画生成
  • テキストから動画生成(マルチショット)
対応モデル: pixverse/pixverse-v6-t2v.
# {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-t2v",
    "input": {
        "prompt": "In a rainy cyber city, a raccoon walks on a railing. Suddenly, its eyes glow blue, and it transforms into a high-tech drone, flying quickly out of the frame."
    },
    "parameters": {
        "size": "1280*720",
        "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 に固定されています。shot_type string生成された動画のショットタイプです。
request_id string追跡とトラブルシューティングに使用する一意のリクエスト識別子です。
  • タスク成功
  • タスク失敗
  • タスク照会の有効期限切れ
{
    "request_id": "19171ea5-9efb-4d35-93a1-xxxxxx",
    "output": {
        "task_id": "7ed706b7-a9a9-4319-820c-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2026-03-20 10:34:41.630",
        "scheduled_time": "2026-03-20 10:34:41.655",
        "end_time": "2026-03-20 10:35:12.725",
        "orig_prompt": "In a rainy cyber city, a raccoon walks on a railing. Suddenly, its eyes glow blue, and it transforms into a high-tech drone, flying quickly out of the frame.",
        "video_url": "https://media.pixverseai.cn/xxxx.mp4"
    },
    "usage": {
        "duration": 5,
        "shot_type": "single",
        "size": "1280*720",
        "fps": 24,
        "video_count": 1,
        "audio": false,
        "SR": "720"
    }
}

DashScope SDK 呼び出し

SDK のパラメーター名は HTTP API とほぼ一致しています。パラメーター構造は各プログラミング言語の特性に合わせて調整されています。 テキストからの動画生成タスクには時間がかかる(通常 1~5 分)ため、SDK は HTTP の非同期呼び出しプロセスをカプセル化しており、同期呼び出しと非同期呼び出しの両方に対応しています。
実際の所要時間は、待機中のタスク数とサービスの実行状況によって異なります。結果が返されるまでしばらくお待ちください。

Python SDK 呼び出し

以下のコードを実行する前に、DashScope Python SDK のバージョンが 2.0.1 以降であることを確認してください。古いバージョンでは、「url error, please check url!」などのエラーが発生する可能性があります。SDK を更新するには、SDK のインストールを参照してください。
シンガポールリージョン: region="ap-southeast-1" {WorkspaceId} を実際のワークスペース ID に置き換えてください。
  • 同期呼び出し
  • 非同期呼び出し
リクエスト例
import os
import dashscope
from dashscope.v2 import DashScopeError

# 以下の設定はシンガポールリージョン用です。{WorkspaceId} を実際のワークスペース ID に置き換えてください。region の値はリージョンによって異なります。
client = dashscope.Client(
    # 環境変数を設定していない場合は、次の行を Model Studio API キーに直接置き換えてください: api_key="sk-xxx"
    # API キーはリージョンによって異なります。API キーの取得: https://www.alibabacloud.com/help/model-studio/get-api-key
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    workspace="{WorkspaceId}",
    region="ap-southeast-1",
)

def sample_sync_call_t2v():
    # 同期 API を呼び出します。結果が直接返されます。
    print('please wait...')
    # generate はワンステップ呼び出し(タスクを送信して完了を待機)で、完了済みの Job を返します
    # audio は名前付きシグネチャに含まれないため、parameters 経由で渡します
    try:
        job = client.videos.generate(model='pixverse/pixverse-v6-t2v',
                                     prompt='In a rainy cyber city, a raccoon walks on a railing. Suddenly, its eyes glow blue, and it transforms into a high-tech drone, flying quickly out of the frame.',
                                     size='1280*720',
                                     duration=5,
                                     watermark=False,
                                     parameters={'audio': False})
        print(job)
        print(job.video_url)
    except DashScopeError as e:
        print(f"HTTP status code: {e.status_code}")
        print(f"Error code: {e.code}")
        print(f"Error message: {e.message}")
        print("See the documentation: https://www.alibabacloud.com/help/ja/model-studio/developer-reference/error-code")

if __name__ == '__main__':
    sample_sync_call_t2v()
レスポンス例
video_url は現在のところ有効期限がありませんが、長期保存を目的としたものではありません。速やかに動画をダウンロードしてください。
{
    "request_id": "2b68d32e-86c8-4383-8a18-xxxxxx",
    "task_id": "ec40bb42-02d4-44d8-bf35-xxxxxx",
    "status": "SUCCEEDED",
    "results": [
        {
            "video_url": "https://media.pixverseai.cn/xxx.mp4"
        }
    ],
    "task_metrics": {
        "TOTAL": 1,
        "SUCCEEDED": 1,
        "FAILED": 0
    },
    "usage": {
        "video_count": 1,
        "video_duration": 0,
        "video_ratio": "",
        "duration": 10,
        "size": "1280x720",
        "fps": 24,
        "audio": false,
        "SR": "720"
    }
}

Java SDK 呼び出し

以下のコードを実行する前に、DashScope Java SDK のバージョンが 2.22.6 以降であることを確認してください。古いバージョンでは、「url error, please check url!」などのエラーが発生する可能性があります。SDK を更新するには、SDK のインストールを参照してください。
シンガポールリージョン: Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1"; {WorkspaceId} を実際のワークスペース ID に置き換えてください。
  • 同期呼び出し
  • 非同期呼び出し
リクエスト例
// {WorkspaceId} を実際のワークスペース ID に置き換えてください。
// Copyright (c) Alibaba, Inc. and its affiliates.

import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesis;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisParam;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisResult;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.utils.JsonUtils;
import com.alibaba.dashscope.utils.Constants;

public class Text2Video {

    static {
        // 以下はシンガポールリージョンの URL です。
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
    }

    // 環境変数を設定していない場合は、次の行を Model Studio の API キーに置き換えてください:api_key="sk-xxx"
    // API キーの取得方法については、https://www.alibabacloud.com/help/model-studio/get-api-key を参照してください
    public static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    /**
     * 動画合成タスクを作成し、タスクの完了を待ちます。
     */
    public static void text2Video() throws ApiException, NoApiKeyException, InputRequiredException {
        VideoSynthesis vs = new VideoSynthesis();
        VideoSynthesisParam param =
                VideoSynthesisParam.builder()
                        .apiKey(apiKey)
                        .model("pixverse/pixverse-v6-t2v")
                        .prompt("In a rainy cyber city, a raccoon walks on a railing. Suddenly, its eyes glow blue, and it transforms into a high-tech drone, flying quickly out of the frame.")
                        .size("1280*720")
                        .duration(5)
                        .audio(true)
                        .watermark(true)
                        .seed(12345)
                        .build();
        System.out.println("please wait...");
        VideoSynthesisResult result = vs.call(param);
        System.out.println(JsonUtils.toJson(result));
    }

    public static void main(String[] args) {
        try {
            text2Video();
        } catch (ApiException | NoApiKeyException | InputRequiredException e) {
            System.out.println(e.getMessage());
        }
        System.exit(0);
    }
}
レスポンス例
video_url は現在のところ有効期限がありませんが、長期保存を目的としたものではありません。速やかに動画をダウンロードしてください。
{
    "request_id": "bd1109bd-6c63-4e62-8bb8-xxxxxx",
    "output": {
        "task_id": "72af7c13-dad5-4aaa-b85d-xxxxxx",
        "task_status": "SUCCEEDED",
        "video_url": "https://media.pixverseai.cn/xxx.mp4",
        "orig_prompt": "In a rainy cyber city, a raccoon walks on a railing. Suddenly, its eyes glow blue, and it transforms into a high-tech drone, flying quickly out of the frame.",
        "submit_time": "2026-03-20 11:21:13.227",
        "scheduled_time": "2026-03-20 11:21:13.252",
        "end_time": "2026-03-20 11:21:43.924"
    },
    "usage": {
        "video_count": 1,
        "duration": 5.0,
        "size": "1280*720",
        "input_video_duration": 0.0,
        "output_video_duration": 0.0,
        "SR": "720"
    },
    "status_code": 200,
    "code": "",
    "message": ""
}

エラーコード

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