Studio API

Generate, verify, and export game-ready 3D models programmatically. Available on the Studio plan.

Authentication

Every request must include your API key in the X-API-Key header. Keys are created in the dashboard (Studio API tab) and can be restricted to specific IP addresses or CIDR ranges.

X-API-Key: pm_3f9a2c... (your full key)
🔒 Keys are stored hashed server-side and shown exactly once at creation. If a key is lost, revoke it and generate a new one. A key with an IP whitelist is rejected from any other address.

Rate limits & billing

GET/api/v1/me

Account info + current credit balance.

curl -H "X-API-Key: pm_..." https://protomaker.ai/api/v1/me

POST/api/v1/generate 10 credits

Generate a full 3D model (spec → CAD → verify → repair → drawings → manufacturer pack). Multipart form-data.

curl -X POST https://protomaker.ai/api/v1/generate \
  -H "X-API-Key: pm_..." \
  -F "description=a desk lamp with an articulated arm" \
  -F "dimensions=height 300mm" \
  -F "image=@sketch.png"

→ {"job_id": "a1b2c3d4e5f6"}

POST/api/v1/analyze 5 credits

Extract spec, generate CAD, and run an independent audit — without packaging. Same form fields as generate.

GET/api/v1/job/{job_id}

Poll status, progress, messages, and artifacts.

curl -H "X-API-Key: pm_..." https://protomaker.ai/api/v1/job/a1b2c3d4e5f6

POST/api/v1/job/{job_id}/export 2 credits

Generate game-engine exports for a completed job: GLB, OBJ, FBX, USDZ (plus STL/STEP). Returns a map of produced files.

GET/api/v1/job/{job_id}/file/{filename}

Download an exported file (e.g. assembly.glb, assembly.obj).

Format targets

© 2026 ProtoMaker — parametric, verified, manufacturer-ready 3D.