Перейти до основного вмісту
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 під час налаштування model.

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

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

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

1

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

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

Опитуйте спільний endpoint відео

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

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

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

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

Поле model у відповіді може показувати визначений id бекенд-моделі, а не псевдонім, який ви надіслали. Використовуйте сторінку Models, щоб знайти актуальні псевдоніми 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
обов'язково