Рекламное видео товара

POST https://api.beatapi.io/v1/ecommerce-video/tasks

Создайте задачу Ecommerce Video из изображений товара, явно указав длительность результата.

Авторизация

Authorization   string   обязательный

Передавайте API-ключ BeatAPI как токен Bearer. Создать ключ можно в панели управления.

Authorization: Bearer <BEATAPI_API_KEY>

Храните постоянные API-ключи на доверенных серверах. Для тела запроса обязателен Content-Type: application/json. Если метод принимает Idempotency-Key, этот заголовок необязателен, но рекомендуется для безопасных повторных попыток с точно таким же телом.

Тело запроса

images   string[]   обязательный

Сначала основное изображение товара или сцены, затем до шести дополнительных общедоступных HTTPS-ссылок на PNG, JPEG или WebP с товаром либо его использованием. Локальные файлы загрузите через POST /v1/files и используйте возвращённый data.url.

Количество: 1 – 7 элементов

duration   integer   обязательный

Обязательная длительность готового видео в секундах; используется для расчёта стоимости в USD. Допустимый диапазон — 10-60 секунд.

Диапазон: 10 – 60

prompt   string   необязательный

Необязательные указания по идее, аудитории, преимуществу товара, предложению, тону, сценам или призыву к действию. Максимум 2000 символов.

Длина: не более 2000 символов

aspect_ratio   enum<string>   необязательный

Формат размещения видео: 16:9 для горизонтального, 9:16 для вертикальных соцсетей, 1:1 для квадратного. Задайте явно, чтобы компоновка была предсказуемой.

Допустимые значения: 16:9, 9:16, 1:1

language   enum<string>   необязательный

Язык диалогов и закадрового текста. en — английский, zh — китайский. Задавайте явно, если промпт содержит несколько языков.

Допустимые значения: en, zh

Ответ

Успешный запрос возвращает HTTP 201.

{
  "data": {
    "id": "task_p9Lm2",
    "object": "task",
    "task_kind": "workflow",
    "capability_id": "ecommerce-video",
    "capability_version": 1,
    "workflow": "ecommerce-video",
    "status": "queued",
    "stage": "queued",
    "created_at": 1782210000,
    "updated_at": 1782210000,
    "completed_at": null,
    "output": null,
    "usage": {
      "credits_reserved": 4.5,
      "credits_charged": 4.5,
      "billable_duration_seconds": 15,
      "credits_settled": 0,
      "credits_refunded": 0
    },
    "request_id": "req_def456",
    "error_code": null,
    "error_message": null
  }
}

Следующий шаг

Сохраните data.id из ответа о принятии задачи и опрашивайте GET /v1/tasks/{task_id} каждые 5–10 секунд, пока status не станет succeeded или failed. Готовые файлы находятся в data.output.media.

Ошибки