API reference

MCP server

janusly-mcp wraps the Janusly API as Model Context Protocol tools, so coding agents like Claude Code, Codex, and Cursor can upload references, render images and video, and poll results for you.

Before you start

You need an API key from Account → API keys (any paid plan) — see Authentication. The server runs locally via npx (Node 18+) and talks to the same /api/v1 endpoints documented in this reference, with the same rate limits and credit billing.

Claude Code

terminal

claude mcp add janusly -e JANUSLY_API_KEY=jl_live_... -- npx -y janusly-mcp

Cursor and other JSON-config clients

Add this to ~/.cursor/mcp.json(or your client's equivalent mcpServers config):

mcp.json

{
  "mcpServers": {
    "janusly": {
      "command": "npx",
      "args": ["-y", "janusly-mcp"],
      "env": { "JANUSLY_API_KEY": "jl_live_..." }
    }
  }
}

Codex

~/.codex/config.toml

[mcp_servers.janusly]
command = "npx"
args = ["-y", "janusly-mcp"]
env = { JANUSLY_API_KEY = "jl_live_..." }

Tools

Field	Type	Description
`get_account`	—	Plan, render-credit balance, and monthly grant — a cheap smoke test that the key works.
`upload_reference`	—	Upload a reference image, video, or audio file from a local path or URL. Returns the blob URL render tools accept.
`generate_image`	—	1-4 images from a prompt, optionally steered by reference images. Waits for completion by default.
`generate_video`	—	Start a video render and return its id immediately — videos take minutes, so waiting is a separate call.
`wait_for_render`	—	Poll a render until it finishes or the timeout elapses; timing out reports progress, not an error.
`get_render_status`	—	One-shot status check without waiting.

Billing & limits

MCP renders spend the same render credits as the app and the raw API, and failed renders refund automatically. Rate limits are per account — the server's polling stays inside the 60/min status budget on its own. Keys act with your account's full render permissions, so treat the JANUSLY_API_KEY value in agent configs like a password.

Environment

Field	Type	Description
`JANUSLY_API_KEY`	—	Required. Your `jl_live_...` key from Account → API keys.
`JANUSLY_API_BASE_URL`	—	Optional. Overrides `https://janusly.com` — only useful for development setups.