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

curl -X POST https://api.beatapi.io/v1/ecommerce-video/tasks \
     -H "Idempotency-Key: ecommerce-create-cus_123-01" \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "images": [
    "https://cdn.beatapi.io/samples/smart-bottle.png"
  ],
  "duration": 15,
  "prompt": "Fast product launch ad for paid social.",
  "aspect_ratio": "9:16"
}'

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

Создайте рекламное видео товара по изображениям товара с явно заданной длительностью.

Если исходный файл локальный, загрузите его и используйте полученный data.url. Сохраните data.id, опрашивайте задачу и соблюдайте правила обработки ошибок и повторов.

Аутентификация

AuthorizationBearer

Передавайте API-ключ в виде Authorization: Bearer <BEATAPI_API_KEY>.

Запрос

This endpoint expects an object.

imageslist of stringsОбязательный

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

durationintegerОбязательный10-60

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

promptstringОпциональный<=2000 characters

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

aspect_ratioenumОпциональный

Целевой формат размещения. Используйте 16:9 для горизонтального видео, 9:16 для вертикального видео соцсетей или 1:1 для квадратного; указывайте явно для стабильной композиции.

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

languageenumОпциональный

Язык диалога и закадрового текста. en — английский, zh — китайский; при смешанных языках в запросе указывайте явно.

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

Ответ

Задача принята

dataobject

Принятое или текущее состояние задачи BeatAPI.

Ошибки

400

Bad Request Error

401

Unauthorized Error

402

Payment Required Error

403

Forbidden Error

409

Conflict Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error

Аутентификация

Заголовки

Запрос

Ответ

Ошибки