建立 Vidu 影片
透過 CometAPI 使用 POST /v1/videos 建立 Vidu Q3 文生影片任務,接著輪詢任務並下載完成的 MP4 檔案。
id,並持續輪詢任務,直到其進入終止狀態。
POST /v1/videos 使用 multipart/form-data;請將純量控制參數作為表單欄位傳入。
選擇模型
設定時長與尺寸
size 設為下列其中一個 WxH 值。
任務流程
建立任務
id。輪詢任務
status 為 completed、failed 或 error。下載結果
completed 時,呼叫 擷取 Vidu 影片內容 以下載 MP4 檔案。授權
Bearer authentication. Use your CometAPI API key.
主體
Vidu Q3 model ID for this endpoint.
viduq3-turbo, viduq3 "viduq3-turbo"
Text prompt that describes the video to generate.
"An astronaut walks through soft blue fog with a slow cinematic camera move."
Requested clip duration in seconds. Use an integer from 1 through 16. Default is 5.
"1"
Supported WxH size values: 640x352, 960x528, 1280x720, 1920x1080. Default is 1280x720.
回應
Task created. Store the returned id and poll GET /v1/videos/{task_id}.
Task ID. Use this value with retrieve and content endpoints.
"task_example"
Object type. Video tasks return video.
"video"
Model ID used for the task.
"viduq3-turbo"
Task lifecycle status. Poll until the value is completed, failed, or error.
queued, in_progress, completed, failed, error "queued"
Task progress as a coarse percentage.
0 <= x <= 1000
Task creation time as a Unix timestamp in seconds.
1779938152
Compatibility alias for id when present.
"task_example"
Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.
1779938219
Temporary video delivery URL. This field appears on completed tasks.
"<temporary-video-url>"
Failure details. This field appears when the task fails.