API and MCP server
Generate from Claude, Cursor or your own scripts with an API key: same models, same credits, failures refunded.
Imaginode beyond the canvas
Everything the canvas can generate is also available outside it: a REST API and an MCP server (Model Context Protocol) let an AI agent or a script create images and videos with your account. Calls spend the credits of your balance, at the same prices as the canvas, and a failed generation is refunded automatically, as always.
MCP is the standard that lets AI assistants (Claude, Cursor and many others) use external tools. Once Imaginode is connected, your assistant can generate an image mid-conversation, illustrate an article it is writing, or produce the visuals of an automated workflow.
Create an API key
Go to your profile, section "API keys". Name the key ("Claude Code", "blog script"…) and create it: the imk_… secret is shown only once, copy it immediately. Five active keys at most, revocable at any time with one click; a revoked key stops working immediately.
Creation requires a verified email, and each key is limited to 10 generations per minute: plenty for real work, not enough to drain a balance by accident if an agent runs away.
Connect the MCP server
The server address is https://imaginode.ai/api/mcp (Streamable HTTP transport). Authenticate by sending your key in the "Authorization: Bearer imk_…" header. In Claude Code, a single command: claude mcp add --transport http imaginode https://imaginode.ai/api/mcp --header "Authorization: Bearer your-key". In Claude.ai or Cursor, add a custom connector with the same address and the same header.
Four tools are exposed. list_models returns the catalogue and prices in credits. generate_image creates an image and waits for the result: the URL is returned directly. generate_video starts a video and returns a tracking id. get_generation_status follows a generation up to the final URL.
The direct REST API
For your scripts, three endpoints are enough. GET /api/models lists the models, their options and their prices, no authentication needed. POST /api/generate starts a generation: a JSON with model, prompt and the model's options (duration, resolution, aspectRatio, audio, imageUrls), the key in the Authorization header, and the response contains requestId, cost and your new balance. GET /api/generate/status?requestId=… returns running, then completed with the output URLs, or failed with the refund.
Input images (imageUrls) must be media hosted on your Imaginode account: import them first into your media, or reuse the URL of a previous generation.
Good practices
Start with an economical model (Flux Schnell, 1 credit) to validate your prompts before moving to premium models. For video, poll the status every 30 seconds: expect 1 to 5 minutes in general, up to 30 for long generations. The exact cost is returned at launch, before the result itself.
A key is a secret: do not commit it to a repository and do not share it. At the slightest doubt, revoke it from your profile and create a new one.