Build with NeoMundo.

Authentication

Create an API key in Settings → API Keys and send it with every request that costs credits or reads your generations.

Authorization: Bearer <YOUR_API_KEY>

Endpoints

Quick start

Generations run asynchronously. Create a task, then poll it every few seconds until the status is succeeded or failed. Failed tasks are refunded automatically.

curl -X POST https://neomundo.art/api/v1/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2",
    "prompt": "Slow dolly-in on a perfume bottle as petals fall, soft morning light",
    "aspect_ratio": "9:16",
    "resolution": "720p",
    "duration": 5
  }'

# => { "data": { "id": "…", "status": "processing", "credits": 198, … } }

curl https://neomundo.art/api/v1/generations/<id> -H "Authorization: Bearer $API_KEY"

# => { "data": { "status": "succeeded", "results": [{ "url": "…", "type": "video" }] } }

Or run an effect / product recipe with just an image:

curl -X POST https://neomundo.art/api/v1/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "effect": "product-white-bg", "images": ["https://…/product.jpg"] }'

MCP server

Connect Claude, Cursor or any MCP client and let your agent search prompts, pick models and generate media for you.

Claude Code

claude mcp add --transport http neomundo https://neomundo.art/api/mcp \
  --header "Authorization: Bearer <YOUR_API_KEY>"

Cursor / other clients

{
  "mcpServers": {
    "neomundo": {
      "url": "https://neomundo.art/api/mcp",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

Available tools:

search_prompts   search the open prompt library
list_models      models and parameters
list_effects     effects and product recipes
generate         start a generation
run_effect       run an effect on images
get_generation   check a task
get_credits      credit balance

Open prompt library

Search community prompts by keyword, type and model. No key required. Each result includes the original author and source link — please keep the attribution when you reuse a prompt.

curl "https://neomundo.art/api/v1/prompts?q=product+ad&type=video&limit=5"

Limits

• API usage uses the same credits as the website; prices are listed in /api/v1/models.
• Up to 8 generations can run at the same time per account.
• Adult and explicit content is not allowed and will be rejected.
• Result files are stored in our storage; download what you need to keep.