Sign in to create and manage your API token.
Each API call consumes credits from your account. Purchase credit packs to use the API. For plans and pricing, see our plans page.
API access uses a tier system. As your lifetime spend grows, your tier unlocks higher API limits.
Current API tier
Sign in to load your current tier.
| Tier | Unlock | Rate limit | Concurrency |
|---|---|---|---|
| Tier 1 | Default | 6 RPM | 1 |
| Tier 2 | $800 lifetime spend | 12 RPM | 2 |
| Tier 3 | $2000 lifetime spend | 18 RPM | 3 |
| Enterprise | Contact sales | Custom | Custom |
Concurrency limits are shown for transparency and will be enforced in a future update.
To upgrade now, buy $800 in credits. Credits do not expire, and all credit purchases count toward your lifetime spend for tier upgrades.
Upload file
Upload an image to get a public URL for use in the sprite API. Use multipart/form-data with field name file_upload.
POST https://www.godmodeai.co/api/generation-api/v1/files/file/local
Send the file as file_upload. A unique path is always generated. Allowed types: PNG, JPEG, WebP, GIF.
Sample code
import requests
r = requests.post(
f"https://www.godmodeai.co/api/generation-api/v1/files/file/local",
headers={"Authorization": f"Bearer your_api_token_here"},
files={"file_upload": ("character.png", open("character.png", "rb"))},
)
r.raise_for_status()
print(r.json()["url"])Sample response (200)
{
"url": "https://your-project.supabase.co/storage/v1/object/public/godmodeai-images/api-upload/a1b2c3d4-e5f6-7890-abcd-ef1234567890.png"
}MCP server (Streamable HTTP)
Add our remote MCP server so agents can generate sprites, remove backgrounds, and list actions as tools. Authenticate with the same API token via the Authorization header.
https://www.godmodeai.co/api/mcp
Client config (Cursor / Claude / generic)
{
"mcpServers": {
"godmodeai": {
"url": "https://www.godmodeai.co/api/mcp",
"headers": { "Authorization": "Bearer your_api_token_here" }
}
}
}stdio-only clients (via mcp-remote)
{
"mcpServers": {
"godmodeai": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://www.godmodeai.co/api/mcp", "--header", "Authorization: Bearer your_api_token_here"]
}
}
}Tools: list_actions, list_models, upload_image, generate_sprite, get_sprite_result, remove_background, get_bg_removal_result.
Agent Skill
We publish a godmodeai-sprites Agent Skill (a SKILL.md package) that teaches Claude and other agents how to pick a valid action, upload an image, and run the generation flow. Install it into Claude, or point Claude Code at it as a plugin marketplace.
It works standalone against the REST API, or alongside the MCP server above for one-call generation.
Download Skill (.skill)How am I billed for API usage?
API usage is credits-only. Each API generation consumes credits from your account balance. There is no separate API subscription fee.
How do API tiers work?
Your tier controls request rate limits. Higher tiers unlock as your account reaches lifetime spend thresholds. Tier 1 starts at 6 RPM, Tier 2 at 12 RPM, and Tier 3 at 18 RPM.
How do I upgrade to a higher tier now?
You just need to buy credits now. Credits do not expire, and your credit purchases count toward lifetime spend, which unlocks higher tiers automatically.