API Kumpix

Crie modelos de joias 3D sob medida com os modelos-base Kumpix a partir do seu próprio site ou software. Cada modelo é construído pelo motor real e retorna peso, pedras, medidas e um arquivo GLB.

Criar chave de API

Autenticação

Toda solicitação leva o cabeçalho Authorization: Bearer KPXA-…. Crie a chave em Conta → API e guarde-a apenas no seu servidor; nunca no código do navegador.

Endpoints

`GET`	`/v1/templates`	Os modelos-base e seus parâmetros: nomes dos campos, opções e limites.
`POST`	`/v1/models`	Constrói um modelo a partir de um modelo-base e retorna peso, número de pedras, medidas e um link GLB. 1 crédito; um modelo já criado com as mesmas configurações é gratuito.
`GET`	`/v1/models/<id>.glb`	O arquivo GLB do modelo (Y para cima, metros; tamanho real em RA).
`GET`	`/v1/credits`	Créditos restantes: os créditos do seu plano neste mês e seus pacotes.

Exemplo de solicitação

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"}}'

Exemplo de resposta

{
  "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
}

Códigos de erro

`400`	Modelo-base ou parâmetro inválido; a mensagem na resposta explica o motivo.
`401`	Sem chave, chave inválida ou sem plano ativo na conta.
`402`	Créditos insuficientes; você pode comprar um pacote de créditos na sua conta.
`429`	O limite de 60 solicitações por minuto por chave foi excedido.

Limites e custo

Até 60 solicitações por minuto por chave. Preços de créditos e planos estão na página de Preços. Preços