Довідник API

Програмний доступ до генерації контенту Qamera AI через публічний REST API.

API Qamera AI дозволяє інтегрувати генерацію продуктової фотографії безпосередньо у ваші застосунки та робочі процеси. Ви можете керувати продуктами, запускати генерацію контенту та отримувати результати без використання веб-інтерфейсу.

Базова URL-адреса

Усі API-запити використовують таку базову URL-адресу:

https://qamera.ai

Якщо ви використовуєте self-hosted розгортання, замініть її на URL-адресу вашого власного розгортання.

Швидкий старт

1. Отримайте API key

Перейдіть до Settings → API Keys у вашому командному робочому просторі та згенеруйте новий ключ. Ваш ключ матиме такий вигляд:

mk_live_abc123.secretvalue

Скопіюйте його одразу — секретна частина показується лише один раз.

2. Зробіть перший запит

Отримайте каталог ваших продуктів:

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

Успішна відповідь повертає JSON-масив ваших продуктів.

Доступні ендпоінти

API організований за такими групами ресурсів:

Products — Перегляд та отримання продуктів з вашого каталогу.
Packshots — Генерація чистих продуктових зображень на білому або довільному фоні.
Photo Shoots — Створення лайфстайл-фотографій зі сценами та моделями, згенерованими ШІ.
Videos — Створення коротких відеороликів з ваших продуктових фото.
Styles — Перегляд та отримання візуальних пресетів для повторного використання.
Orders — Відстеження замовлень на генерацію контенту та їхнього статусу.
Jobs — Моніторинг окремих завдань генерації в межах замовлення.

GET-ендпоінти безкоштовні та не витрачають кредити. POST-ендпоінти, що запускають генерацію контенту, витрачають кредити відповідно до вашого тарифного плану.

Автентифікація

Усі запити вимагають API key. Ви можете передати його за допомогою заголовка X-Api-Key або Authorization: Bearer. Дивіться сторінку Автентифікація для повної інформації про формат ключа, scope та безпеку.

Наступні кроки

Автентифікація — Формат ключа, scope та найкращі практики безпеки.
Обмеження запитів — Ліміти запитів та стратегії повторних спроб.
Коди помилок — HTTP-коди статусу та формат відповідей з помилками.
Кредити — Як працює резервування та витрачання кредитів.

Автентифікація

Формат API key, варіанти заголовків, scope та практики безпеки для API Qamera AI.

Обмеження запитів

Ліміти запитів, обробка відповіді 429 та стратегії повторних спроб для API Qamera AI.

Коди помилок

HTTP-коди статусу та формат відповідей з помилками для API Qamera AI.

Кредити

Як працює резервування, витрачання та повернення кредитів API для генерації контенту.

Products

Отримання завантажених зображень продуктів для вашого акаунта.

Packshots

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

Фотосесії

Перегляд згенерованих зображень фотосесій та реєстрація нових завдань фотосесій.

Моделі

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

Декорації

Перегляд та генерація декорацій і фонів для продуктової фотографії.

Відео

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

Пресети

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

Замовлення

Відстеження замовлень на генерацію, опитування їхнього статусу та читання результатів окремих завдань, включно з адресами файлів і категоріями помилок.

Приклади

Повні приклади інтеграції з використанням curl, JavaScript та Python.