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 リクエスト。クレジットの価格とプランは料金ページにあります。料金