API de Kumpix

Cree modelos de joyería 3D a medida con las plantillas de Kumpix desde su propio sitio o software. Cada modelo lo construye el motor real y devuelve su peso, piedras, medidas y un archivo GLB.

Crear una clave de API

Autenticación

Cada solicitud lleva el encabezado Authorization: Bearer KPXA-…. Cree la clave en Cuenta → API y guárdela solo en su servidor; nunca en el código del navegador.

Endpoints

`GET`	`/v1/templates`	Las plantillas y sus parámetros: nombres de campo, opciones y límites.
`POST`	`/v1/models`	Construye un modelo desde una plantilla y devuelve su peso, número de piedras, medidas y un enlace GLB. 1 crédito; un modelo ya creado con los mismos ajustes es gratuito.
`GET`	`/v1/models/<id>.glb`	El archivo GLB del modelo (Y hacia arriba, metros; tamaño real en RA).
`GET`	`/v1/credits`	Créditos restantes: los créditos de su plan este mes y sus paquetes.

Solicitud de ejemplo

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

Respuesta de ejemplo

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

`400`	Plantilla o parámetro no válido; el mensaje de la respuesta indica el motivo.
`401`	Sin clave, clave no válida o sin plan activo en su cuenta.
`402`	Créditos insuficientes; puede comprar un paquete de créditos desde su cuenta.
`429`	Se superó el límite de 60 solicitudes por minuto por clave.

Límites y coste

Hasta 60 solicitudes por minuto por clave. Los precios de los créditos y los planes están en la página de Precios. Precios