Skip to main content
GET
cURL
在建立 Vidu 影片任務後,使用此端點。它會回傳任務狀態,並在任務完成後包含 video_url

檢查這些欄位

  • status 會告訴你任務是 queuedin_progresscompletedfailederror
  • progress 是粗略的完成百分比。
  • video_url 會出現在已完成的回應中。
  • error 會在任務失敗時出現。

輪詢流程

1

先建立任務

先從建立 Vidu 影片開始,並儲存回傳的 id
2

依 task ID 輪詢

將 task ID 傳送到此端點,直到 status 變成 completedfailederror
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.