Kumpix API

자체 웹사이트나 소프트웨어에서 Kumpix 템플릿으로 치수가 정확한 3D 주얼리 모델을 만드세요. 모든 모델은 실제 엔진이 만들며 무게, 스톤, 치수, GLB 파일을 반환합니다.

인증

모든 요청에는 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회 요청. 크레딧 가격과 요금제는 요금 페이지에 있습니다. 가격