Quickstart: your first 3D model in 2 minutes

Docs · Updated 28 October 2026

To make your first Creations3D model, connect the MCP server to your assistant and ask for an object with a size, or send one REST call with an API key. Either way the model is usually ready about 1.5 minutes after it starts, as a GLB in metres at the size you asked for.

Before you start

• A Creations3D account with credits. New accounts start with a $1, 7-day trial with 40 credits (see pricing). A game-ready model costs 4 credits and a standard one 8.
• For the MCP path: an assistant that supports remote MCP servers. For the REST path: a terminal with curl.

Path 1: from your assistant (MCP)

1. Add the server https://creations3d.com/mcp to your assistant. In Claude Code that is one command:
   claude mcp add --transport http --scope user creations3d https://creations3d.com/mcp
   Other assistants: Claude, ChatGPT, Codex, Cursor.
2. Sign in with your Creations3D email when the assistant opens the browser. No API key is needed.
3. Ask: "Make a low-poly treasure chest, 1 m wide, for my game." The assistant calls create_model with use_for game, target_size 1 and units m.
4. When the model is ready the assistant shows a download link. Ask for "the STL" or "a 3MF" and it calls export_model; exports are free. In a coding agent, ask it to save the GLB into your project.

Path 2: from a script (REST)

1. On the website, open Account, API keys and create a key. Store it as CREATIONS3D_API_KEY.
2. Create the model. The response is 202 with the model's id and status queued:
   curl -s -X POST https://creations3d.com/api/generations \ -H "Authorization: Bearer $CREATIONS3D_API_KEY" \ -H "Content-Type: application/json" \ -d '{"prompt":"low-poly treasure chest","use_for":"game","target_size":1,"units":"m"}'
3. Poll until it is ready or failed, then read it once more:
   ID="YOUR_MODEL_ID" # the id from the create response until curl -s https://creations3d.com/api/generations/$ID \ -H "Authorization: Bearer $CREATIONS3D_API_KEY" | grep -qE '"status":"(ready|failed)"'; do sleep 5 done curl -s https://creations3d.com/api/generations/$ID -H "Authorization: Bearer $CREATIONS3D_API_KEY"
4. Download modelUrl within 15 minutes; read the model again for a fresh link. dimensions gives the size and its units.

What next

• MCP server reference: every tool, field and error.
• REST API reference: every endpoint, with photo uploads and error codes.
• Load the GLB in three.js, or get a printable STL.