Skip to main content
POST
cURL
Bu endpoint’i bir Vidu Q3 text-to-video görevi oluşturmak için kullanın. API hemen bir görev kimliği döndürür, bu nedenle döndürülen id değerini saklayın ve terminal duruma ulaşana kadar görevi sorgulayın. POST /v1/videos multipart/form-data kullanır; skaler kontrolleri form alanları olarak iletin.

Bir model seçin

Süreyi ve boyutu ayarlayın

size değerini aşağıdaki WxH değerlerinden biri olarak ayarlayın.

Görev akışı

1

Görevi oluşturun

Multipart form isteğini gönderin ve döndürülen id değerini saklayın.
2

Görevi sorgulayın

status değeri completed, failed veya error olana kadar Bir Vidu videosunu alın çağrısını yapın.
3

Sonucu indirin

Görev completed olduğunda, MP4 dosyasını indirmek için Vidu video içeriğini alın çağrısını yapın.

Yetkilendirmeler

Authorization
string
header
gerekli

Bearer authentication. Use your CometAPI API key.

Gövde

multipart/form-data
model
enum<string>
gerekli

Vidu Q3 model ID for this endpoint.

Mevcut seçenekler:
viduq3-turbo,
viduq3
Örnek:

"viduq3-turbo"

prompt
string
gerekli

Text prompt that describes the video to generate.

Örnek:

"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.

Örnek:

"1"

size
string

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

Yanıt

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

id
string
gerekli

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

Örnek:

"task_example"

object
string
gerekli

Object type. Video tasks return video.

Örnek:

"video"

model
string
gerekli

Model ID used for the task.

Örnek:

"viduq3-turbo"

status
enum<string>
gerekli

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

Mevcut seçenekler:
queued,
in_progress,
completed,
failed,
error
Örnek:

"queued"

progress
integer
gerekli

Task progress as a coarse percentage.

Gerekli aralık: 0 <= x <= 100
Örnek:

0

created_at
integer
gerekli

Task creation time as a Unix timestamp in seconds.

Örnek:

1779938152

task_id
string

Compatibility alias for id when present.

Örnek:

"task_example"

completed_at
integer

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

Örnek:

1779938219

video_url
string

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

Örnek:

"<temporary-video-url>"

error
object

Failure details. This field appears when the task fails.