Skip to main content
POST
cURL
Bu endpoint’i bir Veo 3.1 video görevi başlatmak için kullanın. API hemen bir görev kimliği döndürür; bu nedenle dönen id değerini saklayın ve terminal bir duruma ulaşana kadar görevi sorgulayın. POST /v1/videos multipart/form-data kullanır; skaler kontrolleri form alanları olarak, medya girdilerini ise input_reference dosya alanları olarak iletin.

Bir model seçin

Bir giriş modu seçin

Süre ve boyut ayarlayın

OpenAI uyumlu yol için, süre adına seconds ve çıktı boyutu için size kullanın. Değerleri form alanları olarak gönderin. 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önen id değerini saklayın.
2

Görevi sorgulayın

status değeri completed, failed veya error olana kadar Veo3 Retrieve kullanın.
3

Sonucu indirin

Görev completed olduğunda, tamamlanan görev yanıtından MP4 dosyasını indirin.

Yetkilendirmeler

Authorization
string
header
gerekli

Bearer authentication. Use your CometAPI API key.

Gövde

multipart/form-data
model
enum<string>
gerekli

Veo 3.1 model ID. Use veo3.1-fast for the default route or veo3.1 when you specifically need the standard model.

Mevcut seçenekler:
veo3.1-fast,
veo3.1
Örnek:

"veo3.1-fast"

prompt
string
gerekli

Text prompt for the video job.

Örnek:

"A paper kite floats above a field."

seconds
enum<string>
varsayılan:4

Requested clip duration. Use 4, 6, or 8. Send the value as a form field string.

Mevcut seçenekler:
4,
6,
8
Örnek:

"4"

size
string

Supported WxH size values: 1280x720, 720x1280, 1920x1080, 3840x2160. Default is 1280x720.

Örnek:

"1280x720"

input_reference
file

Optional first-frame image file for image-to-video.

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:

"veo3.1-fast"

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.