API Kumpix

Créez des modèles de bijoux 3D aux mesures exactes avec les gabarits Kumpix depuis votre propre site ou logiciel. Chaque modèle est construit par le vrai moteur et revient avec son poids, ses pierres, ses dimensions et un fichier GLB.

Créer une clé API

Authentification

Chaque requête porte l'en-tête Authorization: Bearer KPXA-…. Créez la clé dans Compte → API et gardez-la uniquement sur votre serveur ; jamais dans le code du navigateur.

Points d'accès

`GET`	`/v1/templates`	Les gabarits et leurs paramètres : noms des champs, options et limites.
`POST`	`/v1/models`	Construit un modèle à partir d'un gabarit et renvoie son poids, le nombre de pierres, ses dimensions et un lien GLB. 1 crédit ; un modèle déjà construit avec les mêmes réglages est gratuit.
`GET`	`/v1/models/<id>.glb`	Le fichier GLB du modèle (Y vers le haut, mètres ; taille réelle en RA).
`GET`	`/v1/credits`	Crédits restants : les crédits de votre formule ce mois-ci et vos packs.

Exemple de requête

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

Exemple de réponse

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

Codes d'erreur

`400`	Gabarit ou paramètre non valide ; le message de la réponse en donne la raison.
`401`	Pas de clé, clé non valide ou aucune formule active sur son compte.
`402`	Crédits insuffisants ; vous pouvez acheter un pack de crédits depuis votre compte.
`429`	La limite de 60 requêtes par minute et par clé a été dépassée.

Limites et coût

Jusqu'à 60 requêtes par minute et par clé. Les prix des crédits et les formules figurent sur la page Tarifs. Tarifs