Перейти к основному содержанию
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. При указании model выберите актуальный alias Veo на странице Models page.

Выберите шаблон запроса

  • Текст в видео: не отправляйте файлы input_reference
  • Изображение в видео: отправьте один input_reference
  • Guidance по первому и последнему кадру: отправьте два упорядоченных файла input_reference

Поток задачи

1

Отправьте задачу Veo

Отправьте alias Veo, prompt и при необходимости входные изображения, затем сохраните возвращённый id.
2

Опрашивайте общий video endpoint

Используйте Veo3 Retrieve, чтобы отслеживать асинхронную задачу, пока она не перейдёт в терминальное состояние.
3

Сохраните результат

Переместите готовый asset в собственное хранилище, если вашему приложению нужна долговечная копия.

Разрешение alias

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

Авторизации

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
обязательно