Skip to main content
GET
cURL
Bu endpoint’i, bir Vidu video görevi oluşturduktan sonra kullanın. Görev durumunu döndürür ve görev tamamlandıktan sonra video_url alanını içerir.

Bu alanları kontrol edin

  • status, görevin queued, in_progress, completed, failed veya error durumda olup olmadığını belirtir.
  • progress, yaklaşık bir tamamlanma yüzdesidir.
  • video_url, tamamlanmış yanıtlarda görünür.
  • error, bir görev başarısız olduğunda görünür.

Polling akışı

1

Önce görevi oluşturun

Bir Vidu videosu oluştur ile başlayın ve döndürülen id değerini saklayın.
2

Task ID ile polling yapın

status, completed, failed veya error değerine ulaşana kadar task ID’yi bu endpoint’e gönderin.
3

MP4 dosyasını indirin

status değeri completed olduğunda, Vidu video içeriğini alma çağrısını yapın.

Yetkilendirmeler

Authorization
string
header
gerekli

Bearer authentication. Use your CometAPI API key.

Yol Parametreleri

task_id
string
gerekli

Task ID returned by POST /v1/videos.

Yanıt

Current Vidu video task state.

id
string
gerekli

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

Örnek:

"task_example"

object
string
gerekli

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