BETAAPI v1 — available on Studio plan

XERON API Reference

Integrate XERON's AI capabilities directly into your tools, pipelines, or platform. All endpoints require authentication via Bearer token.

Base URL

url
https://xeron-labs.com/api

Authentication

All API requests must include a valid API key in the Authorization header. Generate your key in Account → API Keys (Studio plan).

bash
curl https://xeron-labs.com/api/generate \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"A platformer game","engine":"godot","mode":"smart"}'

Never expose your API token in client-side code. Use it only in server-side environments.

Rate Limits

Code Generation
10 requests / minute
Game Generation
3 requests / 5 minutes
Vision (Images)
5 requests / minute
Sound
5 requests / minute
Motion (Video)
3 requests / 5 minutes
Chat
20 messages / minute

Endpoints

POST/api/v1/generate Auth required

External API — generate game code using your API key. Supports JSON and SSE streaming.

Request Body

json
{
  "prompt": "A 2D platformer with player movement",
  "engine": "godot",
  "stream": false
}

Response

json
{
  "code": "extends CharacterBody2D\n\nconst SPEED = 200.0\n...",
  "creditsUsed": 15,
  "creditsRemaining": 285
}
POST/api/v1/generate (stream) Auth required

Same endpoint with stream: true — returns an SSE stream of code deltas.

Request Body

json
{
  "prompt": "A 2D platformer with player movement",
  "engine": "godot",
  "stream": true
}

Response

json
data: {"delta": "extends CharacterBody2D\n"}
data: {"delta": "\nconst SPEED = 200.0\n"}
data: {"type": "done", "creditsUsed": 15, "creditsRemaining": 285}
POST/api/generate Auth required

In-app code generation (session cookie auth)

Request Body

json
{
  "prompt": "A 2D platformer with player movement",
  "engine": "godot",
  "mode": "script"
}

Response

json
{
  "result": "extends CharacterBody2D\n...",
  "creditsUsed": 15,
  "creditsRemaining": 285
}
POST/api/game-generation Auth required

Generate a complete multi-file game (SSE stream)

Request Body

json
{
  "prompt": "Top-down RPG with inventory system",
  "engine": "godot",
  "complexity": "medium"
}

Response

json
data: {"type":"plan","gameName":"Epic RPG","totalFiles":12}
data: {"type":"generating","file":"Player.gd","index":1,"total":12}
data: {"type":"file_complete","file":"Player.gd","index":1}
data: {"type":"complete","files":[...],"creditsUsed":100}
POST/api/vision Auth required

Generate a game asset or concept art image

Request Body

json
{
  "prompt": "Forest dungeon entrance, pixel art",
  "style": "Pixel Art",
  "resolution": "512",
  "model": "flux"
}

Response

json
{
  "imageUrl": "https://storage.xeron-labs.com/...",
  "creditsUsed": 30
}
POST/api/sound Auth required

Generate background music or SFX

Request Body

json
{
  "prompt": "Epic boss battle theme",
  "type": "music",
  "mood": "Epic",
  "duration": 30
}

Response

json
{
  "audioUrl": "https://storage.xeron-labs.com/...",
  "creditsUsed": 50
}
GET/api/plugin/poll?code=XXXXXX

Poll for pending code delivery (used by engine plugins)

Response

json
// No pending delivery
{ "waiting": true }

// Delivery ready
{
  "type": "code",
  "engine": "godot",
  "code": "extends Node\n...",
  "filename": "Player.gd"
}

SDKs & Libraries

🟨

JavaScript / TypeScript

Coming soon

🐍

Python

Coming soon

🎮

GDScript (Godot)

Plugin available →