Vidu - 最初のフレームから動画を生成する API リファレンス

使用上の注意

API 呼び出しを成功させるには、モデル、エンドポイント URL、API キーを同じリージョンのものに統一する必要があります。リージョンをまたぐ呼び出しは失敗します。

モデルの選択: モデルのリージョンを確認します。
URL の選択: 対応するエンドポイント URL を選択します。HTTP と DashScope SDK の両方の URL に対応しています。
API キーの設定: リージョンを選択し、API キーを取得してから、API キーを環境変数に設定します。

このページのサンプルコードはシンガポールリージョンに適用されます。

HTTP 呼び出し

画像から動画への生成には通常 1～5 分かかるため、API は非同期方式を使用します。処理は、タスクを作成し、結果をポーリングするという 2 つの主要ステップで構成されます。

ステップ 1：タスクの作成

シンガポールリージョン: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis

タスクの作成後、返された task_id で結果を照会します。task_id は 24 時間有効です。同じタスクを重複して作成せず、ポーリングで結果を取得してください。
初めて使用する場合は、Postman または cURL による API 呼び出しを参照してください。

リクエストパラメーター

ヘッダー

Content-Type string (必須)リクエストのコンテンツタイプです。application/json を指定する必要があります。Content-Type string (必須)リクエストのコンテンツタイプです。application/json を指定する必要があります。X-DashScope-Async string (必須)非同期処理を有効にします。HTTP リクエストは非同期呼び出しのみに対応しています。enable を指定する必要があります。

このリクエストヘッダーがない場合、エラー「current user api does not support synchronous calls」が返されます。

リクエスト本文

model string (必須)モデル名です。有効な値：

vidu/viduq2-pro-fast_img2video

input object (必須)テキストプロンプトとメディア素材を含む基本入力です。

プロパティ

prompt string (任意)生成する動画に含めたい要素や視覚的な特徴を説明するテキストプロンプトです。最大長は 5,000 文字です（中国語の文字も英字も 1 文字として数えます）。上限を超える部分は切り詰められます。media array (必須)生成に使用する画像を指定するメディア素材のリストです。配列の各要素は、type フィールドと url フィールドを含むメディアオブジェクトです。

プロパティ

type string (必須)メディア素材の種類です。次の固定値を指定する必要があります。

image: 画像の URL。

素材の制限：画像素材を1 つ指定する必要があります。url string (必須)画像ファイルの URL です。パブリックにアクセスできる必要があります。

対応プロトコル：HTTP または HTTPS。
例： https://example.com/image.jpg.

画像の制限：

形式：JPG、JPEG、PNG、WEBP。
アスペクト比：1:4～4:1。
ファイルサイズ：最大 50 MB。

parameters object (任意)解像度や長さなど、動画処理のパラメーターです。

プロパティ

resolution string (任意)

resolution の設定は料金に直接影響します。呼び出し前にモデル料金を確認してください。

生成する動画の解像度の区分を指定します。モデルは入力画像のアスペクト比を維持しながら、選択した解像度区分に近い画素数に動画を拡大・縮小します。有効な値は 720P と 1080P です。デフォルトは 720P です。duration integer (任意)

duration の設定は、秒単位で課金される料金に直接影響します。動画が長いほど料金が高くなります。呼び出し前にモデル料金を確認してください。

生成する動画の長さ（秒）です。[1, 10] の範囲の整数です。デフォルトは 5 です。audio boolean (任意)watermark boolean (任意)ウォーターマークを追加するかどうかを指定します。動画の右下に、固定テキスト「Generated by AI」のウォーターマークが配置されます。

false: （デフォルト）ウォーターマークを追加しません。
true: ウォーターマークを追加します。

seed integer (任意)乱数シードは [0, 2147483647] の範囲の整数である必要があります。省略するとランダムなシードが生成されます。固定シードを使用すると再現性が向上します。モデルの生成は確率的であるため、同じシードでも同一の結果は保証されません。

画像から動画への生成

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": "vidu/viduq2-pro-fast_img2video",
    "input": {
        "media": [
            {
                "type": "image",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260121/zlpocv/wan-i2v-haigui.webp"
            }
        ],
        "prompt": "The camera slowly pans up from below a sea turtle that is swimming leisurely, with clear details of its belly visible."
    },
    "parameters": {
        "duration": 5,
        "resolution": "720P",
        "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"
}

タスクの作成に失敗しました。エラーコードを参照してください。

{
    "code": "InvalidApiKey",
    "message": "Invalid API-key provided.",
    "request_id": "7438d53d-6eb8-4596-8835-xxxxxx"
}

ステップ 2：結果の照会

シンガポールリージョン: GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}

ポーリングの推奨事項: 動画の生成には数分かかる場合があります。15 秒ごとなど、適切な間隔で結果をポーリングしてください。
タスク状態の遷移: PENDING（待機中）→ RUNNING（処理中）→ SUCCEEDED（成功）/ FAILED（失敗）。
タスク ID の有効期間: task_id は24 時間有効です。有効期限が切れると照会は失敗し、状態 UNKNOWN が返されます。
RPS 制限: 照会エンドポイントのデフォルトの制限は 20 RPS です。高頻度の照会やイベント通知には、非同期タスクのコールバックを設定してください。
その他の操作: 一括照会、タスクのキャンセルなどの操作については、非同期タスクの管理を参照してください。

リクエストパラメーター

ヘッダー

Authorization string (必須)Model Studio の API キーでリクエストを認証します。例：Bearer sk-xxxx。

パスパラメーター

task_id string (必須)タスクの ID です。

タスク結果の照会

{task_id} を前の API 呼び出しで返された task_id に置き換えます。task_id は 24 時間以内の照会に使用できます

curl -X GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

レスポンスパラメーター

outputobjectタスクの出力情報です。

プロパティ

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

列挙値

PENDING
RUNNING
SUCCEEDED
FAILED
CANCELED
UNKNOWN：タスクが存在しないか、状態が不明です。

ポーリング中の状態遷移：

PENDING → RUNNING → SUCCEEDED または FAILED。
最初の照会時の状態は通常 PENDING または RUNNING です。
状態が SUCCEEDED になると、レスポンスに生成された動画の URL が含まれます。
状態が FAILED の場合は、エラーメッセージを確認してタスクを再試行してください。

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 です。end_time stringタスクの完了時刻です。形式は YYYY-MM-DD HH:mm:ss.SSS です。orig_prompt string動画の URL です。task_status が SUCCEEDED の場合のみ返されます。動画の形式は MP4（H.264 エンコーディング）です。動画リンクの有効期間は 24 時間です。速やかにダウンロードしてください。orig_prompt string入力された元のプロンプトです。リクエストパラメーター prompt に対応します。code stringエラーコードです。リクエストが失敗した場合のみ返されます。エラーコードを参照してください。message string詳細なエラーメッセージです。リクエストが失敗した場合のみ返されます。エラーコードを参照してください。

usage object出力の使用量統計です。成功したタスクのみが集計対象です。

プロパティ

duration integer課金対象の動画の合計時間（秒）です。output_video_durationinteger出力動画の長さ（秒）です。size string出力動画の解像度です。fps integer出力動画のフレームレートです。24 に固定されています。SR string出力動画の解像度区分です。audio boolean出力が音声付き動画かどうかを示します。video_count integer出力動画の数です。1 に固定されています。

request_id string追跡とトラブルシューティングに使用する一意のリクエスト識別子です。

タスク成功
タスク失敗
タスク照会の有効期限切れ

{
    "request_id": "3606f9f4-b833-44ec-8385-xxxxxx",
    "output": {
        "task_id": "2846881f-0496-4288-947f-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2026-03-27 14:25:32.057",
        "scheduled_time": "2026-03-27 14:25:32.084",
        "end_time": "2026-03-27 14:28:29.600",
        "orig_prompt": "The camera slowly pans up from below a sea turtle that is swimming leisurely, with clear details of its belly visible.",
        "video_url": "https://prod-ss-vidu.s3.cn-northwest-1.amazonaws.com.cn/xxx.mp4?xxxx"
    },
    "usage": {
        "duration": 5,
        "size": "990*932",
        "output_video_duration": 5,
        "fps": 24,
        "video_count": 1,
        "audio": false,
        "SR": "720"
    }
}

タスクが失敗すると、task_status は FAILED になり、エラーコードとメッセージが返されます。エラーコードを参照してください。

{
    "request_id": "e5d70b02-ebd3-98ce-9fe8-759d7d7b107d",
    "output": {
        "task_id": "86ecf553-d340-4e21-af6e-a0c6a421c010",
        "task_status": "FAILED",
        "code": "InvalidParameter",
        "message": "The size is not match xxxxxx"
    }
}

task_id は 24 時間有効です。有効期限が切れると、照会時に次のエラーが返されます。

{
    "request_id": "a4de7c32-7057-9f82-8581-xxxxxx",
    "output": {
        "task_id": "502a00b1-19d9-4839-a82f-xxxxxx",
        "task_status": "UNKNOWN"
    }
}

エラーコード

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

​使用上の注意

​HTTP 呼び出し

​ステップ 1：タスクの作成

リクエストパラメーター

ヘッダー

リクエスト本文

レスポンスパラメーター

​ステップ 2：結果の照会

リクエストパラメーター

ヘッダー

パスパラメーター

レスポンスパラメーター

​エラーコード

使用上の注意

HTTP 呼び出し

ステップ 1：タスクの作成

ステップ 2：結果の照会

エラーコード