// api reference

Summon monsters straight from your agent.

/* One authenticated API call returns a game-ready, rigged, animated GLB — straight into Codex, Cursor, or your own script. Every call requires a signed-in account and an API key. */

// quickstart

Three steps to your first GLB

1

Sign in & create an API key

Sign in with Google or GitHub, open your Account page, and create an API key under API keys. Copy it — it's shown once. New accounts include 3 free generations.

2

Call the API with your key

Every request carries your API key as a Bearer token — the API is login-only, anonymous calls are rejected. The response is a binary .glb. A free call returns a randomized monster; choosing body / weapon / palette is a paid-plan feature.

# free tier: just ?seed=42 — paid plans can add body/weapon/palette
curl "https://gobkit.com/api/generate?seed=42&body=normal&weapon=sword&palette=slate" \
  -H "Authorization: Bearer gk_live_your_api_key" \
  -o goblin.glb
3

Drop the GLB into your game

Load it in Three.js, your engine, or hand the file to your agent. It ships rigged with idle / walk / attack clips — ready to play. Each generation spends one credit; re-fetching a monster you already made is free.

// in Codex / Cursor, tell your agent:
"Call the Gobkit API with my key to generate a goblin enemy,
 download the .glb, and add it to my game as the first enemy."
// endpoints

Reference

GET /api/generateRequires login (API key or session) — anonymous calls get 401. Params: seed (uint, required). Paid plans may also pass body (short/normal/heavy/giant), weapon (unarmed/dagger/sword/greatsword/spear/axe/greataxe), palette (slate/red/green/blue/amber/violet). Returns a .glb. Spends 1 credit; 402 when out of credits. POST /api/keysCreate an API key — shown once. Create & revoke keys on your Account page. GET /api/meYour account: plan, remaining credits, and reset date (signed-in session).

Auth: an API key or your logged-in session — both require an account and spend the same credit balance. New accounts include 3 free generations. Payments & tax are handled by Paddle. MCP direct-call is on the roadmap.