Kumpix-API

Erstellen Sie mit Kumpix-Vorlagen maßgenaue 3D-Schmuckmodelle von Ihrer eigenen Website oder Software aus. Jedes Modell wird von der echten Engine erstellt und liefert Gewicht, Steine, Maße und eine GLB-Datei.

API-Schlüssel erstellen

Authentifizierung

Jede Anfrage trägt den Header Authorization: Bearer KPXA-…. Erstellen Sie den Schlüssel unter Konto → API und bewahren Sie ihn nur auf Ihrem Server auf; niemals im Browser-Code.

Endpunkte

`GET`	`/v1/templates`	Vorlagen und ihre Parameter: Feldnamen, Optionen und Grenzen.
`POST`	`/v1/models`	Erstellt ein Modell aus einer Vorlage und liefert Gewicht, Steinanzahl, Maße und einen GLB-Link. 1 Credit; ein bereits mit denselben Einstellungen erstelltes Modell ist kostenlos.
`GET`	`/v1/models/<id>.glb`	Die GLB-Datei des Modells (Y nach oben, Meter; echte Größe in AR).
`GET`	`/v1/credits`	Verbleibende Credits: die Credits Ihres Plans in diesem Monat und Ihre Pakete.

Beispielanfrage

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

Beispielantwort

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

Fehlercodes

`400`	Ungültige Vorlage oder ungültiger Parameter; die Meldung in der Antwort nennt den Grund.
`401`	Kein Schlüssel, ein ungültiger Schlüssel oder kein aktiver Plan im Konto.
`402`	Nicht genügend Credits; Sie können in Ihrem Konto ein Kreditpaket kaufen.
`429`	Das Limit von 60 Anfragen pro Minute und Schlüssel wurde überschritten.

Grenzen und Kosten

Bis zu 60 Anfragen pro Minute und Schlüssel. Credit-Preise und Pläne finden Sie auf der Preisseite. Preise