Ana içeriğe atla
POST
/
v1
/
videos
Create a Veo video job
curl --request POST \
  --url https://api.cometapi.com/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'prompt=A paper kite floats above a field.' \
  --form input_reference='@example-file'
{
  "created_at": 1773297229,
  "id": "task_pa9CKKtYlTdxO7IIHOKKhXfjxEu4EQoR",
  "model": "veo_3_1-4K",
  "object": "video",
  "progress": 0,
  "seconds": "",
  "size": "16x9",
  "status": "queued"
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Bu sayfayı, paylaşılan CometAPI /v1/videos rotası üzerinden bir Veo işi başlatmak için kullanın. model ayarlarken Models sayfasından güncel bir Veo alias seçin.

İstek düzenini seçin

  • Metinden videoya: hiçbir input_reference dosyası göndermeyin
  • Görüntüden videoya: bir input_reference gönderin
  • İlk kare ve son kare yönlendirmesi: sıralı iki input_reference dosyası gönderin

Görev akışı

1

Veo işini gönderin

Bir Veo alias, prompt ve isteğe bağlı görüntü girdileri gönderin, ardından döndürülen id değerini kaydedin.
2

Paylaşılan video endpoint'ini sorgulayın

Asenkron görevi terminal bir duruma ulaşana kadar takip etmek için Veo3 Retrieve kullanın.
3

Sonucu kalıcı olarak saklayın

Uygulamanızın kalıcı bir kopyaya ihtiyacı varsa tamamlanan varlığı kendi depolamanıza taşıyın.

Alias çözümleme

Yanıttaki model alanı, gönderdiğiniz alias yerine çözümlenmiş backend model kimliğini gösterebilir. Güncel Veo alias’larını bulmak için Models sayfasını kullanın.

Yetkilendirmeler

Authorization
string
header
gerekli

Bearer token authentication. Use your CometAPI key.

Gövde

multipart/form-data
prompt
string
gerekli

Text prompt for the video job.

Örnek:

"A paper kite floats above a field."

model
string
varsayılan:veo3-fast

CometAPI Veo alias. Use a current Veo alias from the Models page. The response may resolve this alias to a provider model id.

Örnek:

"veo3-fast"

size
string

Orientation hint. Use a landscape-like value such as 16x9 or a portrait-like value such as 9x16.

Örnek:

"16x9"

input_reference
file

Optional image input. Send one file for image-to-video or two ordered files for first-frame and last-frame guidance.

Yanıt

200 - application/json

Task accepted.

created_at
integer
gerekli
id
string
gerekli
model
string
gerekli

Provider model identifier resolved by CometAPI for this task.

object
string
gerekli
progress
integer
gerekli
seconds
string
gerekli
size
string
gerekli
status
string
gerekli