Veo 3 videosu oluşturun

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=veo3.1-fast \
  -F 'prompt=A paper kite floats above a field.' \
  -F seconds=4 \
  -F size=1280x720

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "veo3.1-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Metinden veya bir görüntüden Veo 3.1 videosu oluşturun. API hemen bir görev kimliği döndürür. Görevi sorgulamak ve tamamlanan videoyu indirmek için döndürülen id değerini saklayın. POST /v1/videos multipart/form-data kullanır. Denetimleri form alanları olarak, bir görüntüyü ise input_reference dosya alanı olarak gönderin.

Model seçin

Model kimliği	Ne zaman kullanılmalı	Notlar
`veo3.1-fast`	Çoğu kısa klip için varsayılan seçenek	Daha hızlı Veo 3.1 yolu.
`veo3.1`	Özellikle standart Veo 3.1 modelini kullanmak istediğinizde kullanın	Standart Veo 3.1 yolu.

Girdi modu seçin

Amaç	Zorunlu alanlar	İsteğe bağlı alanlar
Metinden videoya	`model`, `prompt`	`seconds`, `size`
Görüntüden videoya	`model`, `prompt`, bir adet `input_reference` görüntü dosyası	`seconds`, `size`

Bir görüntüyü canlandırmak için, alanı bir kez kullanarak input_reference aracılığıyla tek bir dosya yükleyin. Görüntü açılış karesini belirler; prompt ise sonraki hareketi ve kamera davranışını açıklar.

Süreyi ve boyutu ayarlayın

Bu OpenAI uyumlu yol için süreyi açık bir tamsayı seconds değeriyle, çıktı boyutunu ise size ile ayarlayın. Her iki değeri de form alanları olarak gönderin.

Model kimliği	`seconds`	Varsayılan
`veo3.1-fast`	`4`, `6`, `8`	`4` saniye, `1280x720`
`veo3.1`	`4`, `6`, `8`	`4` saniye, `1280x720`

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

Çözünürlük katmanı	En-boy oranı	`size` (`WxH`)
`720p`	`16:9`	`1280x720`
	`9:16`	`720x1280`
`1080p`	`16:9`	`1920x1080`
`4K`	`16:9`	`3840x2160`

Görev akışı

Görevi oluşturun

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

Görevi sorgulayın

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

Sonucu indirin

Görev completed olduğunda, tamamlanmış 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<integer>

varsayılan:4

Requested clip duration in whole seconds. Send 4, 6, or 8 as a form field.

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

One image file that sets the opening frame for image-to-video. Send input_reference once with one file. Use prompt to describe the motion and camera behavior that follow.

Yanıt

Task created. Store the returned id and poll GET /v1/videos/{task_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.

Son değiştirilme tarihi 9 Eylül 2026

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=veo3.1-fast \
  -F 'prompt=A paper kite floats above a field.' \
  -F seconds=4 \
  -F size=1280x720

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "veo3.1-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

İçerik moderasyonu

API anahtarları

Model seçin

Girdi modu seçin

Süreyi ve boyutu ayarlayın

Görev akışı

Yetkilendirmeler

Gövde

Yanıt

​Model seçin

​Girdi modu seçin

​Süreyi ve boyutu ayarlayın

​Görev akışı

Yetkilendirmeler

Gövde

Yanıt

Model seçin

Girdi modu seçin

Süreyi ve boyutu ayarlayın

Görev akışı