Asenkron Video Generation

CometAPI içinde POST /v1/videos üzerinden Veo3 videolarını asenkron olarak üretin; bir görev kimliği döndürür ve 8 saniyelik klipler için ilk/son kare yönlendirmesini destekler.

POST /v1/videos

Create a Veo video job

cURL

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'

200

{
  "created_at": 1773297229,
  "id": "task_pa9CKKtYlTdxO7IIHOKKhXfjxEu4EQoR",
  "model": "veo_3_1-4K",
  "object": "video",
  "progress": 0,
  "seconds": "",
  "size": "16x9",
  "status": "queued"
}

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

​

İstek düzenini seçin

• Text-to-video: hiçbir input_reference dosyası göndermeyin
• Image-to-video: bir adet 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örsel girdileri gönderin, ardından dönen 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 kalıcı bir kopyaya ihtiyaç duyuyorsa, tamamlanan varlığı kendi depolamanıza taşıyın.

​

Alias çözümleme

Google, Veo’yu Gemini’nin uzun süren video işlemleri üzerinden belgelendirir ve veo-3.1-generate-preview gibi model adları kullanır. CometAPI, paylaşılan /v1/videos rotasını korur ve istek anında Models page üzerinden güncel bir Veo alias çözümler. 2026-03-12 tarihinde yapılan canlı doğrulama sırasında, veo3-fast ile yapılan bir istek kabul edildi ve bir asenkron görev kimliği döndürdü; yanıttaki model, gönderilen alias’ı aynen yansıtmak yerine bir sağlayıcı model kimliğine çözümlendi.

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 used by the wrapper. 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