Getting Started

Generate, refine, and export 3D models programmatically through the Thrixel API.

Working through a coding agent?

If Claude Code, Codex, or Cursor is the one making the calls, install the MCP server instead of writing a poll loop by hand. It wraps these same endpoints and handles the waiting.

What is Thrixel?

Thrixel turns text prompts and reference images into production-ready 3D models through a simple REST API. You submit a request, poll (or stream) until it's ready, then download the result in GLB, FBX, OBJ, STL, or USDZ.

Base URL

https://api.thrixel.com/api/v1

Authentication

Authenticated endpoints require an API key passed as a Bearer token, in the format sk-thrixel-....

To create one, sign in at thrixel.com/create, then open Profile > API Keys > Create new Key. Copy the key right away, it is only shown once.

Authorization: Bearer sk-thrixel-<YOUR_KEY>

Public endpoints (info, stream, downloads, convert, gallery) do not require authentication.

Rate Limits

Each API key is subject to three limits (defaults shown — your plan may differ):

Concurrent jobs — 3 active (queued or processing) submissions at a time
Hourly — 10 requests per rolling hour
Daily — 50 requests per rolling 24 hours

Quickstart

Submit a text prompt, wait for the job to complete, and download the GLB:

# 1. Submit a prompt
curl -X POST https://api.thrixel.com/api/v1/architect/submit \
  -H "Authorization: Bearer sk-thrixel-<YOUR_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"task": "a small stone gargoyle holding a lantern"}'
# → {"submission_id": "abc-123", "status": "queued", "created_at": "..."}
 
# 2. Poll until completed
curl https://api.thrixel.com/api/v1/abc-123/info
# → {"status": "completed", ...}
 
# 3. Download the GLB
curl -L -o model.glb https://api.thrixel.com/api/v1/abc-123/download?format=glb