API Reference

Generate game art with a single API call

Pixel art, HD sprites, tilesets, and UI elements. Send a prompt, get production-ready assets back in seconds.

Want your AI agent to generate sprites automatically? See the agent setup guide

Authentication

API Keys

All requests use Bearer token authentication. Create a key in your SpriteCook dashboard and include it in the Authorization header.

Authorization: Bearer sc_live_xxxxxxxxxxxxxxxxxxxx...

Get Your API Key

Endpoints

Available Routes

Reference

Generate Parameters

All parameters for POST /v1/api/generate and POST /v1/api/generate-sync. Only prompt is required.

Parameter	Type	Default	Description
`prompt`required	string	--	What to generate, e.g. "a medieval iron sword, side view"
`width`	int	64	Image width in pixels (16-512)
`height`	int	64	Image height in pixels (16-512)
`variations`	int	1	Number of variations (1-4)
`pixel`	bool	true	Pixel art (true) or detailed HD art (false)
`pixel_perfect`	bool	true	Grid-aligned pixel post-processing
`bg_mode`	string	"transparent"	"transparent", "white", or "include"
`theme`	string	null	Art theme context, e.g. "dark fantasy medieval"
`style`	string	null	Style direction, e.g. "16-bit SNES style"
`aspect_ratio`	string	"1:1"	"1:1", "16:9", or "9:16"
`smart_crop`	bool	true	Auto-crop to content bounds
`mode`	string	"assets"	"assets", "texture", or "ui"
`model`	string	"gemini-2.5-flash-image"	AI model to use
`resolution`	string	"1K"	"1K", "2K", or "4K"
`colors`	string[]	null	Color palette, hex codes (max 8)
`reference_asset_id`	string	null	Asset ID for style reference (consistent art)
`edit_asset_id`	string	null	Asset ID to edit/modify
`project_id`	string	null	Assign output to a project (UUID)

Examples

Quick Examples

curl -X POST https://api.spritecook.ai/v1/api/generate-sync \
  -H "Authorization: Bearer sc_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a medieval iron sword, side view",
    "width": 64,
    "height": 64,
    "pixel": true,
    "bg_mode": "transparent"
  }'

Agent Setup

Using SpriteCook with AI agents?

If you're connecting SpriteCook to Cursor, VS Code, Claude, or another MCP-compatible editor, use the one-command installer. It configures everything automatically.

Terminal

$curl -fsSL https://spritecook.ai/install.sh | bash

Full agent setup guide

Billing

Credits & Errors

Credit Costs

Base cost: 8 credits per image
Multiple variations multiply the cost
Higher resolution may cost more

Every response includes credits_used and credits_remaining.

Common Errors

402insufficient_creditsNot enough credits

429rate_limitedToo many concurrent jobs

403scope_deniedKey missing required scope

400invalid_requestBad parameters

Start generating

Create an account, grab an API key, and generate your first sprite in under a minute.

Create Account Get API Key