Skip to main content
POST
このエンドポイントを使用して、Vidu Q3 のテキストから動画または画像から動画へのタスクを作成します。API はタスク ID をすぐに返すため、返された id を保存し、タスクが終端状態になるまでポーリングします。 POST /v1/videos multipart/form-data を使用します。スカラーの制御値はフォームフィールドとして送信し、参照画像は input_reference ファイルフィールドとして指定します。

​
入力モードを選択

API キーで利用可能な Vidu モデル ID を確認するには、次を使用します 利用可能なモデルを一覧表示.

​
参照画像を使用

画像から動画の場合、multipart フィールド input_reference を通じて参照画像を1枚アップロードします。ファイルサイズは最大 20 MB です。 画像は、生成される動画の構図と外観をガイドします。プロンプトには、動画で維持する動き、カメラの動作、細部を記述します。

​
再生時間とサイズを設定

size を以下の WxH 値のいずれかに設定します。

​
タスクのフロー

1

タスクを作成

multipart フォームリクエストを送信し、返された id を保存します。
2

タスクをポーリング

次の操作として Vidu 動画の取得 を呼び出し、status が completed、failed、または error になるまで待ちます。
3

結果をダウンロード

タスクが completed になったら、 Vidu 動画コンテンツの取得 を呼び出して MP4 ファイルをダウンロードします。

承認

​
Authorization
string
header
必須

Bearer authentication. Use your CometAPI API key.

ボディ

multipart/form-data
​
model
string
必須

Vidu Q3 model ID for this route. Choose an available model from the Models page.

例:

"viduq3-turbo"

​
prompt
string
必須

Text prompt that describes the video to generate. For image-to-video, describe the motion and camera behavior that should animate the reference image.

例:

"An astronaut walks through soft blue fog with a slow cinematic camera move."

​
seconds
string

Requested clip duration in seconds. Use an integer from 1 through 16. Default is 5.

例:

"1"

​
size
string

Supported WxH size values: 960x528, 1280x720, 1920x1080. Default is 1280x720.

​
input_reference
file

One reference image file for image-to-video. Omit this field for text-to-video. The file can be up to 20 MB. The image guides the composition and appearance of the generated video.

レスポンス

Task created. Store the returned id and poll GET /v1/videos/{task_id}.

​
id
string
必須

Task ID. Use this value with retrieve and content endpoints.

例:

"task_example"

​
object
string
必須

Object type. Video tasks return video.

例:

"video"

​
model
string
必須

Model ID used for the task.

例:

"viduq3-turbo"

​
status
enum<string>
必須

Task lifecycle status. Poll until the value is completed, failed, or error.

利用可能なオプション:
queued,
in_progress,
completed,
failed,
error
例:

"queued"

​
progress
integer
必須

Task progress as a coarse percentage.

必須範囲: 0 <= x <= 100
例:

0

​
created_at
integer
必須

Task creation time as a Unix timestamp in seconds.

例:

1779938152

​
task_id
string

Compatibility alias for id when present.

例:

"task_example"

​
completed_at
integer

Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.

例:

1779938219

​
video_url
string

Temporary video delivery URL. This field appears on completed tasks.

例:

"<temporary-video-url>"

​
error
object

Failure details. This field appears when the task fails.

最終更新日 2026年8月12日