API & MCP Integration

Integrate Ludo.ai directly into your workflow with our powerful API and MCP support.

Getting Started

Ludo.ai's API and MCP integration allows you to leverage our generative AI models directly within your own applications and workflows. Automate asset creation, streamline your pipeline, and access our full suite of tools programmatically.

Available Features

Images & Animation

Create sprites, icons, UI assets, textures, and backgrounds. Bring them to life with spritesheet animations.

Video & 3D

Generate videos from images with motion prompts. Convert 2D art into textured 3D models, then auto-rig and animate them with text prompts or presets.

Audio

Create sound effects, music tracks, and character voices. Clone voices for text-to-speech.

Which plan do I need?

Lowest plan with API & MCP

Pro

$50/mo

1,000 generation credits / month

API & MCP access included

Studio

$350/mo

10,000 generation credits / month · 10 seats

API & MCP access included

API & MCP access is not available on the Free trial or Indie plans. Studio adds more seats, higher rate limits, and concurrent generation jobs. Compare all plans →

In 3 Simple Steps:

Subscribe to Pro or Studio

API and MCP access is included on the Pro and Studio plans.

Get Your API Key

Start Integrating

Use the MCP integration for AI assistants or the REST API for custom apps.

What a generation costs

API and MCP requests consume credits, even on plans with unlimited web features. Each Pro or Studio plan includes a monthly credit allowance; here's what typical calls cost:

Image / sprite / icon0.5 credits

Sprite-sheet animationfrom 4 credits

3D model (GLB)3 credits

3D auto-rig1 credit

Videofrom 1.3 credits

Sound effect2 credits

Music track3 credits

Voice / text-to-speech1 credit

Video, sprite animation, and motion transfer are billed per second based on the model you choose (roughly 1-4 credits/second). See the full credit cost table for every feature.

MCP (Model Context Protocol)

Connect Ludo.ai to AI assistants like Claude using the Model Context Protocol. Generate game assets, animate sprites, and create visuals directly through natural language conversations.

One-click install:Add to Cursor Add to VS Codethen paste your API key

MCP Server URL

https://mcp.ludo.ai/mcp

Use this URL to connect any MCP-compatible client.

Authentication Header

Authentication: ApiKey YOUR_API_KEY

Run this command to add Ludo.ai as an MCP server:

claude mcp add ludo https://mcp.ludo.ai/mcp -t http -H "Authentication: ApiKey YOUR_API_KEY"

1Replace YOUR_API_KEY with your Ludo.ai API key.

2Run the command in your terminal to register the MCP server.

Add Ludo.ai to OpenAI Codex by editing ~/.codex/config.toml:

[mcp_servers.ludo-ai]
url = "https://mcp.ludo.ai/mcp"

[mcp_servers.ludo-ai.http_headers]
Authentication = "ApiKey YOUR_API_KEY"

Replace YOUR_API_KEY with your Ludo.ai API key, then restart Codex so it reconnects with the new configuration.

Add Ludo.ai to Cursor using either the Settings UI or manual configuration:

Option 1: Cursor Settings UI

Open Cursor Settings (Cmd+, on Mac or Ctrl+, on Windows/Linux)
Go to Tools & MCP section and click New MCP Server
Set Server Name to ludo-ai
Set Transport Type to http
Set URL to https://mcp.ludo.ai/mcp
Add a header: Authentication with value ApiKey YOUR_API_KEY
Save and restart Cursor

Option 2: Manual Configuration

Edit your Cursor MCP config file at ~/.cursor/mcp.json (or .cursor/mcp.json in your project):

{
  "mcpServers": {
    "ludo-ai": {
      "url": "https://mcp.ludo.ai/mcp",
      "transport": "http",
      "headers": {
        "Authentication": "ApiKey YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with your Ludo.ai API key, then restart Cursor.

Option 3: mcp-remote proxy (fallback)

If the direct HTTP connection above doesn't connect, use the mcp-remote proxy instead. It runs locally via npx and bridges to our server. Add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "ludo-ai": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.ludo.ai/mcp",
        "--transport",
        "http-only",
        "--header",
        "Authentication: ApiKey YOUR_API_KEY"
      ]
    }
  }
}

Replace YOUR_API_KEY with your Ludo.ai API key, then restart Cursor. Requires Node.js installed (for npx).

REST API

Build custom integrations with Ludo.ai using our comprehensive REST API. Generate game assets, animate sprites programmatically, and integrate AI-powered asset creation into your pipeline. Full API reference.

Base URL

https://api.ludo.ai/api/

All endpoints are relative to this base URL.

AuthenticationInclude this header in all API requests:

Authentication: ApiKey YOUR_API_KEY

Full programmatic access to asset generation features

RESTful endpoints with JSON responses

Safe retries: re-sending the same request_id returns the existing job instead of charging twice

Every response carries an X-Ludo-Job-Id header, so a dropped connection never loses a generation

Comprehensive documentation with examples

Async Generation

Generations run as jobs by default, so your scripts never have to hold a connection open:

Send a generation request as usual and get an instant 202with a job id.
Fetch the result with GET /assets/jobs/{id}?wait=30: the call waits up to 30 seconds and returns the moment your generation finishes.
List recent jobs with GET /assets/jobs, or cancel a queued one with DELETE /assets/jobs/{id} (credits refunded).

Synchronous responses are deprecated. They still work if you add "async": false to a request body, but new integrations should use jobs.

Generation History

GET /assets/generations lists everything you have generated: filter by type, search by text, and choose the source (api, web, or all), paginated newest first.

API-generated results expire after 7 days, so download anything you want to keep. Fair use: up to 50 generations queued or running per account, and 150 read requests per 5 minutes.

View API Documentation

Using Unity? Check out our Unity Plugin to generate assets directly in the Editor.

Need help with integration?

Join our DiscordorContact us