The AutoSprite REST API lets you create characters, generate animations, and export sprite sheets programmatically — from any language that can make an HTTPS request. Build custom asset pipelines, wire generation into your game's build, or automate batch jobs. API access is included with a **subscription plan**. Create and manage your keys on the [API Keys page](/app/api-keys). ## Base URL ``` https://www.autosprite.io/api/v1 ``` ## Authentication Every request takes your secret key, which starts with `vspk_`. Pass it in the `x-api-key` header (recommended) or as a Bearer token: ```bash # x-api-key header (recommended) curl https://www.autosprite.io/api/v1/account \ -H "x-api-key: vspk_your_key_here" # or as a Bearer token curl https://www.autosprite.io/api/v1/account \ -H "Authorization: Bearer vspk_your_key_here" ``` ## The workflow Generation is a short, asynchronous loop: create a character, request animations, then poll the job until the sprite sheet is ready. ```bash curl -X POST https://www.autosprite.io/api/v1/characters \ -H "x-api-key: vspk_your_key_here" \ -H "Content-Type: application/json" \ -d '{"name": "Knight", "prompt": "knight with a blue cape, pixel art"}' ``` ```bash curl -X POST https://www.autosprite.io/api/v1/characters/CHARACTER_ID/spritesheets \ -H "x-api-key: vspk_your_key_here" \ -H "Content-Type: application/json" \ -d '{"animations": [{"kind": "walk"}, {"kind": "run"}, {"kind": "attack"}]}' ``` ```bash curl https://www.autosprite.io/api/v1/jobs/JOB_ID \ -H "x-api-key: vspk_your_key_here" ``` When the job reaches `succeeded`, the response includes the sprite sheet IDs. Fetch a sheet to get its PNG and atlas download URLs. Keep your API key secret. Never commit it to version control or ship it in client-side code. ## Reference

Start with the Quick Start → ## Prefer your editor? If you work in an AI coding assistant like Claude Code or Cursor, the [MCP integration](/docs/mcp) gives you the same capabilities as conversational tools — no HTTP calls required.