Skip to main content
GET
cURL
Vidu 動画タスクを作成した後にこのエンドポイントを使用します。タスクの状態を返し、タスク完了後は video_url が含まれます。

以下のフィールドを確認してください

  • status は、タスクが queuedin_progresscompletedfailed、または error のどれであるかを示します。
  • progress は大まかな完了率です。
  • video_url は完了したレスポンスに表示されます。
  • error はタスクが失敗したときに表示されます。

ポーリングの流れ

1

まずタスクを作成

最初に Vidu 動画を作成 から開始し、返された id を保存します。
2

task ID でポーリング

statuscompletedfailed、または error になるまで、このエンドポイントに task ID を送信します。
3

MP4 ファイルをダウンロード

statuscompleted の場合は、Vidu 動画コンテンツを取得 を呼び出します。

承認

Authorization
string
header
必須

Bearer authentication. Use your CometAPI API key.

パスパラメータ

task_id
string
必須

Task ID returned by POST /v1/videos.

レスポンス

Current Vidu video task state.

id
string
必須

Task ID. Use this value as task_id in retrieve and content requests.

:

"task_example"

object
string
必須

Object type. Vidu 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. The value matches 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.