Generasi Video Async

Buat video Veo3 secara asynchronous melalui POST /v1/videos di CometAPI, mengembalikan task id dan mendukung panduan frame pertama/terakhir untuk klip 8 detik.

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

Gunakan halaman ini untuk memulai job Veo melalui rute bersama CometAPI /v1/videos. Pilih alias Veo yang saat ini tersedia dari halaman Models saat menetapkan model.

​

Pilih pola permintaan

• 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 hasil

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

​

Resolusi alias

Field model dalam response mungkin menampilkan id model backend yang sudah di-resolve alih-alih alias yang Anda kirimkan. Gunakan halaman Models untuk menemukan alias Veo yang saat ini tersedia.

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