API Kumpix

Создавайте точные 3D-модели украшений по шаблонам Kumpix со своего сайта или из своей программы. Каждую модель строит настоящий движок и возвращает её вес, камни, размеры и файл GLB.

Создать API-ключ

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

Каждый запрос содержит заголовок Authorization: Bearer KPXA-…. Создайте ключ в разделе Аккаунт → API и храните его только на сервере; никогда не добавляйте его в код браузера.

Эндпоинты

`GET`	`/v1/templates`	Шаблоны и их параметры: имена полей, варианты и ограничения.
`POST`	`/v1/models`	Строит модель по шаблону и возвращает вес, число камней, размеры и ссылку на GLB. 1 кредит; модель, уже построенная с теми же настройками, бесплатна.
`GET`	`/v1/models/<id>.glb`	Файл GLB модели (ось Y вверх, метры; реальный размер в AR).
`GET`	`/v1/credits`	Осталось кредитов: кредиты Вашего тарифа в этом месяце и пакеты.

Пример запроса

curl -X POST https://motor.kumpix.com/v1/models \
  -H "Authorization: Bearer KPXA-…" \
  -H "Content-Type: application/json" \
  -d '{"type": "band", "params": {"width": 4, "ring_size": "US 7", "metal": "18k_gold"}}'

Пример ответа

{
  "id": "5f1c0a9e7b2d4c6e8a0b1c2d",
  "type": "band",
  "metal": "18k_gold",
  "grams": 4.12,
  "stones": 0,
  "dimensions": { "width_mm": 4.0, "inner_diameter_mm": 17.35 },
  "model": "https://motor.kumpix.com/v1/models/5f1c0a9e7b2d4c6e8a0b1c2d.glb",
  "charged": true,
  "credits_left": 299
}

Коды ошибок

`400`	Недопустимый шаблон или параметр; сообщение в ответе объясняет причину.
`401`	Нет ключа, ключ недействителен или в аккаунте нет активного тарифа.
`402`	Недостаточно кредитов; пакет кредитов можно купить в аккаунте.
`429`	Превышен лимит 60 запросов в минуту на ключ.

Ограничения и стоимость

До 60 запросов в минуту на ключ. Цены кредитов и тарифы — на странице цен. Цены