Документация API
REST API виртуальной примерки. Базовый URL: https://api.artrx.ru/v1
Авторизация
Передавайте секретный ключ в заголовке Authorization: Bearer …. Создайте ключ в кабинете и храните его только на сервере.
Authorization: Bearer artrx_live_…Создать примерку
POST /try-on · multipart/form-data
Поля: category, person_image, garment_image. Также можно передать external_id. Категории: upper_body, lower_body, dress, full_body. Файлы JPG, PNG или WebP до 8 МиБ каждый.
curl -X POST https://api.artrx.ru/v1/try-on \ -H "Authorization: Bearer $ARTRX_API_KEY" \ -H "Idempotency-Key: order-1042-tryon" \ -F "category=upper_body" \ -F "person_image=@person.jpg" \ -F "garment_image=@jacket.jpg"
Успешный ответ: 202 Accepted с task_id и статусом queued. Повтор с тем же ключом идемпотентности не создаёт дубль.
Статус и результат
GET /tasks/{task_id}. Статусы: queued, processing, completed, failed, canceled. Когда result.available=true, скачайте файл запросом GET /tasks/{task_id}?download=1. Срок доступности указан в available_until.
Проверить баланс
GET /balance. Суммы возвращаются в копейках: balance_minor, reserved_minor, available_minor.
Ограничения запросов
Ограничения зависят от тарифа компании. Тариф, пополнение и доступ к генерации настраивает менеджер.
Частые ошибки: 401 — неверный ключ; 403 — нет доступа; 409 — конфликт идемпотентности; 422 — неверные поля; 429 — превышен лимит; 503 — сервис или тариф недоступен.