API Kumpix

Crei modelli di gioielli 3D su misura con i modelli base Kumpix dal Suo sito o software. Ogni modello è costruito dal vero motore e restituisce peso, pietre, misure e un file GLB.

Crea una chiave API

Autenticazione

Ogni richiesta porta l'intestazione Authorization: Bearer KPXA-…. Crei la chiave in Account → API e la conservi solo sul Suo server; mai nel codice del browser.

Endpoint

`GET`	`/v1/templates`	I modelli base e i loro parametri: nomi dei campi, opzioni e limiti.
`POST`	`/v1/models`	Costruisce un modello da un modello base e restituisce peso, numero di pietre, misure e un link GLB. 1 credito; un modello già creato con le stesse impostazioni è gratuito.
`GET`	`/v1/models/<id>.glb`	Il file GLB del modello (Y in alto, metri; dimensione reale in AR).
`GET`	`/v1/credits`	Crediti rimasti: i crediti del Suo piano questo mese e i Suoi pacchetti.

Richiesta di esempio

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

Risposta di esempio

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

Codici di errore

`400`	Modello base o parametro non valido; il messaggio nella risposta ne indica il motivo.
`401`	Nessuna chiave, chiave non valida o nessun piano attivo sul suo account.
`402`	Crediti insufficienti; può acquistare un pacchetto di crediti dal Suo account.
`429`	È stato superato il limite di 60 richieste al minuto per chiave.

Limiti e costi

Fino a 60 richieste al minuto per chiave. Prezzi dei crediti e piani sono nella pagina Prezzi. Prezzi