Langsung ke konten utama
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"
}
Gunakan halaman ini untuk memulai job Veo melalui rute bersama CometAPI /v1/videos. Pilih alias Veo terbaru dari halaman Models saat menetapkan model.

Pilih pola request

  • Text-to-video: jangan kirim file input_reference
  • Image-to-video: kirim satu input_reference
  • Panduan frame pertama dan frame terakhir: kirim dua file input_reference yang berurutan

Alur task

1

Kirim job Veo

Kirim alias Veo, prompt, dan input gambar opsional, lalu simpan id yang dikembalikan.
2

Poll endpoint video bersama

Gunakan Veo3 Retrieve untuk mengikuti task async hingga mencapai status terminal.
3

Simpan hasilnya

Pindahkan aset yang sudah selesai ke storage Anda sendiri jika aplikasi Anda memerlukan salinan yang persisten.

Resolusi alias

Google mendokumentasikan Veo melalui operasi video berjalan lama milik Gemini dan menggunakan nama model seperti veo-3.1-generate-preview. CometAPI mempertahankan rute bersama /v1/videos dan menyelesaikan alias Veo terbaru dari halaman Models pada saat request. Selama validasi langsung pada 2026-03-12, request dengan veo3-fast diterima dan mengembalikan task id async, dan model pada respons diselesaikan menjadi provider model id alih-alih menggemakan alias yang dikirim.

Otorisasi

Authorization
string
header
wajib

Bearer token authentication. Use your CometAPI key.

Body

multipart/form-data
prompt
string
wajib

Text prompt for the video job.

Contoh:

"A paper kite floats above a field."

model
string
default: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.

Contoh:

"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.

Contoh:

"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.

Respons

200 - application/json

Task accepted.

created_at
integer
wajib
id
string
wajib
model
string
wajib

Provider model identifier resolved by CometAPI for this task.

object
string
wajib
progress
integer
wajib
seconds
string
wajib
size
string
wajib
status
string
wajib