Асинхронная генерация видео

Асинхронно генерируйте видео Veo3 через POST /v1/videos в CometAPI, получая id задачи и используя указание первого/последнего кадра для 8-секундных клипов.

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

Используйте эту страницу, чтобы запустить задачу Veo через общий маршрут CometAPI /v1/videos. При указании model выберите актуальный псевдоним Veo на странице Models page.

​

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

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

​

Поток задачи

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

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

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

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

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

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

​

Разрешение псевдонима

Поле model в ответе может содержать разрешённый id backend-модели, а не псевдоним, который вы отправили. Используйте страницу Models page, чтобы найти актуальные псевдонимы Veo.

Авторизации

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