Відео

Перегляд відео, генерація окремих відео із зображень та створення рілсів з кількох зображень.

GET /api/external/videos

Повертає список згенерованих відео.

Заголовки

Заголовок	Обов'язковий	Опис
X-Api-Key	Так	Ваш API key у форматі `mk_live_xxx.secret`

Параметри запиту

Параметри запиту відсутні.

Відповідь

{
  "videos": [
    {
      "id": "vid_abc123",
      "name": "Product Showcase - White T-Shirt",
      "thumbnail": "https://cdn.example.com/videos/thumb_abc123.jpg",
      "videoUrl": "https://cdn.example.com/videos/vid_abc123.mp4",
      "status": "DONE",
      "voting": "APPROVED",
      "createdAt": "2026-03-20T17:00:00.000Z"
    }
  ],
  "count": 1
}

Відповіді з помилками

Код	Значення
401	Відсутній або недійсний API key
500	Внутрішня помилка сервера

Примітки

Цей ендпоінт не витрачає кредити.

Приклад

curl -X GET "https://qamera.ai/api/external/videos" \
  -H "X-Api-Key: mk_live_abc123.secret456"

POST /api/external/video-picker/register-videos

Генерує відео з існуючого зображення. Кредити резервуються негайно та витрачаються після завершення обробки.

Заголовки

Заголовок	Обов'язковий	Опис
X-Api-Key	Так	Ваш API key у форматі `mk_live_xxx.secret`
Content-Type	Так	`application/json`

Тіло запиту

Поле	Тип	Обов'язковий	Опис
imageId	string	Умовний	ID вихідного зображення. Потрібен `imageId` або `generatedImageId`.
generatedImageId	string	Умовний	ID згенерованого зображення. Потрібен `imageId` або `generatedImageId`.
suggestion	string	Ні	Творчі вказівки або пропозиції щодо руху для відео
provider	string	Ні	Провайдер генерації відео (за замовчуванням: `pollo`)

Відповідь

{
  "createdRecordIds": ["vid_001"],
  "batchId": "batch_abc123",
  "orderId": "order_xyz789",
  "reservationId": "res_def456",
  "creditsReserved": 10
}

Відповіді з помилками

Код	Значення
400	Недійсне тіло запиту або відсутній обов'язковий ID зображення
401	Відсутній або недійсний API key
402	Недостатньо кредитів
500	Внутрішня помилка сервера

Примітки

Обробка відбувається асинхронно. Завдання публікується в чергу повідомлень та обробляється воркером.
Відстежуйте статус згенерованих відео за допомогою GET-ендпоінта.
Кредити резервуються при створенні, витрачаються після успішної обробки та повертаються у разі невдачі.
Кожен запит генерує correlationId для трасування логів.
Потрібно вказати або imageId, або generatedImageId, але не обидва.

Приклад

curl -X POST "https://qamera.ai/api/external/video-picker/register-videos" \
  -H "X-Api-Key: mk_live_abc123.secret456" \
  -H "Content-Type: application/json" \
  -d '{
    "imageId": "img_abc123",
    "suggestion": "Slow zoom in with subtle rotation",
    "provider": "pollo"
  }'

POST /api/external/reel/register-reel

Генерує рілс (короткоформатне відео) з кількох зображень. Кредити резервуються негайно та витрачаються після завершення обробки.

Заголовки

Заголовок	Обов'язковий	Опис
X-Api-Key	Так	Ваш API key у форматі `mk_live_xxx.secret`
Content-Type	Так	`application/json`

Тіло запиту

Поле	Тип	Обов'язковий	Опис
imagesIds	string[]	Так	Масив ID зображень для включення в рілс (мін: 1, макс: 10)

Відповідь

{
  "createdRecordIds": ["reel_001"],
  "batchId": "batch_abc123",
  "orderId": "order_xyz789",
  "reservationId": "res_def456",
  "creditsReserved": 15
}

Відповіді з помилками

Код	Значення
400	Недійсне тіло запиту, відсутній imagesIds або розмір масиву поза межами
401	Відсутній або недійсний API key
402	Недостатньо кредитів
500	Внутрішня помилка сервера

Примітки

Обробка відбувається асинхронно. Завдання публікується в чергу повідомлень та обробляється воркером.
Відстежуйте статус згенерованих рілсів за допомогою GET /api/external/videos ендпоінта.
Кредити резервуються при створенні, витрачаються після успішної обробки та повертаються у разі невдачі.
Кожен запит генерує correlationId для трасування логів.
Масив imagesIds повинен містити від 1 до 10 ID зображень.

Приклад

curl -X POST "https://qamera.ai/api/external/reel/register-reel" \
  -H "X-Api-Key: mk_live_abc123.secret456" \
  -H "Content-Type: application/json" \
  -d '{
    "imagesIds": ["img_001", "img_002", "img_003", "img_004"]
  }'