Kumpix API

สร้างโมเดลเครื่องประดับ 3D ขนาดแม่นยำด้วยเทมเพลต Kumpix จากเว็บไซต์หรือซอฟต์แวร์ของคุณเอง ทุกโมเดลสร้างด้วยเอนจินจริง และส่งกลับน้ำหนัก อัญมณี ขนาด และไฟล์ 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 คำขอต่อนาทีต่อคีย์ ราคาเครดิตและแผนอยู่ในหน้าราคา ราคา