Моделі

Перегляд та генерація ШІ-моделей (манекенів) для продуктової фотографії.

GET /api/external/models

Повертає список доступних ШІ-моделей (манекенів).

Заголовки

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

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

Поле	Тип	Обов'язковий	Опис
statusFilter	string	Ні	Фільтр за статусом: `all` (за замовчуванням) або `approved`

Відповідь

{
  "models": [
    {
      "id": "model_abc123",
      "name": "Female Model - Casual",
      "thumbnail": "https://cdn.example.com/models/thumb_abc123.jpg",
      "status": "DONE",
      "voting": "APPROVED",
      "createdAt": "2026-03-20T14:00:00.000Z"
    }
  ],
  "count": 1
}

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

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

Примітки

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

Приклад

curl -X GET "https://qamera.ai/api/external/models?statusFilter=approved" \
  -H "X-Api-Key: mk_live_abc123.secret456"

POST /api/external/models/register-ideas

Реєструє нове завдання генерації ШІ-моделі. Кредити резервуються негайно та витрачаються після завершення обробки.

Заголовки

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

Тіло запиту

Поле	Тип	Обов'язковий	Опис
preferences	string	Так	Текстовий опис бажаного зовнішнього вигляду та характеристик моделі
count	number	Ні	Кількість моделей для генерації (за замовчуванням: 10, максимум: 20)

Відповідь

{
  "createdRecordIds": ["model_001", "model_002", "model_003"],
  "batchId": "batch_abc123",
  "orderId": "order_xyz789",
  "reservationId": "res_def456",
  "creditsReserved": 30
}

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

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

Примітки

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

Приклад

curl -X POST "https://qamera.ai/api/external/models/register-ideas" \
  -H "X-Api-Key: mk_live_abc123.secret456" \
  -H "Content-Type: application/json" \
  -d '{
    "preferences": "Young female model, athletic build, natural makeup, suitable for sportswear photography",
    "count": 5
  }'