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 次请求。积分价格和套餐请见价格页面。价格