Kumpix API

अपनी वेबसाइट या सॉफ़्टवेयर से Kumpix टेम्पलेट के साथ सटीक माप वाले 3D ज्वेलरी मॉडल बनाएँ। हर मॉडल असली इंजन बनाता है और उसका वज़न, पत्थर, माप और GLB फ़ाइल लौटाता है।

API कुंजी बनाएँ

प्रमाणीकरण

हर अनुरोध में Authorization: Bearer KPXA-… हेडर होता है। कुंजी खाता → API पेज पर बनाएँ और उसे केवल अपने सर्वर पर रखें; ब्राउज़र कोड में कभी नहीं।

एंडपॉइंट

`GET`	`/v1/templates`	टेम्पलेट और उनके पैरामीटर: फ़ील्ड नाम, विकल्प और सीमाएँ।
`POST`	`/v1/models`	टेम्पलेट से मॉडल बनाता है और वज़न, पत्थरों की संख्या, माप और GLB लिंक लौटाता है। 1 क्रेडिट; उन्हीं सेटिंग्स से पहले बना मॉडल मुफ़्त है।
`GET`	`/v1/models/<id>.glb`	मॉडल की GLB फ़ाइल (Y ऊपर, मीटर; AR में असली आकार)।
`GET`	`/v1/credits`	शेष क्रेडिट: इस महीने आपके प्लान के क्रेडिट और आपके पैक।

उदाहरण अनुरोध

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

उदाहरण उत्तर

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

त्रुटि कोड

`400`	अमान्य टेम्पलेट या पैरामीटर; उत्तर का संदेश कारण बताता है।
`401`	कोई कुंजी नहीं, अमान्य कुंजी, या उसके खाते में कोई सक्रिय प्लान नहीं।
`402`	पर्याप्त क्रेडिट नहीं; आप अपने खाते से क्रेडिट पैक खरीद सकते हैं।
`429`	प्रति कुंजी प्रति मिनट 60 अनुरोधों की सीमा पार हो गई।

सीमाएँ और लागत

प्रति कुंजी प्रति मिनट अधिकतम 60 अनुरोध। क्रेडिट मूल्य और प्लान मूल्य पेज पर हैं। कीमतें