Перейти до основного вмісту
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"
}
Використовуйте цю сторінку, щоб запустити завдання Veo через спільний маршрут CometAPI /v1/videos. Виберіть актуальний псевдонім Veo на сторінці Models page під час налаштування model.

Виберіть шаблон запиту

  • Text-to-video: не надсилайте файли input_reference
  • Image-to-video: надішліть один input_reference
  • Підказки за першим і останнім кадром: надішліть два впорядковані файли input_reference

Потік виконання завдання

1

Надішліть завдання Veo

Надішліть псевдонім Veo, prompt і, за потреби, вхідні зображення, а потім збережіть повернений id.
2

Опитуйте спільний video endpoint

Використовуйте Veo3 Retrieve, щоб відстежувати асинхронне завдання, доки воно не досягне кінцевого стану.
3

Збережіть результат

Перемістіть готовий asset у власне сховище, якщо вашому застосунку потрібна довготривала копія.

Визначення псевдоніма

Google документує Veo через довготривалі відеооперації Gemini і використовує назви моделей, як-от veo-3.1-generate-preview. CometAPI зберігає спільний маршрут /v1/videos і визначає актуальний псевдонім Veo зі сторінки Models page під час виконання запиту. Під час живої валідації 2026-03-12 запит із veo3-fast було прийнято й повернуто id асинхронного завдання, а model у відповіді було визначено як id моделі провайдера, а не просто повторено надісланий псевдонім.

Авторизації

Authorization
string
header
обов'язково

Bearer token authentication. Use your CometAPI key.

Тіло

multipart/form-data
prompt
string
обов'язково

Text prompt for the video job.

Приклад:

"A paper kite floats above a field."

model
string
за замовчуванням: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.

Приклад:

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

Приклад:

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

Відповідь

200 - application/json

Task accepted.

created_at
integer
обов'язково
id
string
обов'язково
model
string
обов'язково

Provider model identifier resolved by CometAPI for this task.

object
string
обов'язково
progress
integer
обов'язково
seconds
string
обов'язково
size
string
обов'язково
status
string
обов'язково