← All articles

NS-Image API and MCP: how to add image generation to your project

A glowing cube with abstract faces

NS-Image is NeuralSpace own image generation model. NeuralSpace offers the following models: NS-Image. They all run through a single public API, and there is a ready MCP server for AI agents. The key is issued on the API keys page. Below are the model capabilities, request examples and setup steps.

What NS-Image can do

NS-Image is NeuralSpace own image generation model. It has a single price per image, supports references (image-to-image) and aspect ratios auto, 16:9, 9:16, 3:4, 4:3 and 1:1. The model is available in the site dashboard, the API and MCP.

API endpoint

Send a request to POST /v1/images/generations. Example: {"model": "ns-image", "prompt": "an abstract composition", "aspect_ratio": "16:9"}. Authorization uses an API key in the x-api-key header. Available model ids: ns-image.

A glowing cube with faces

MCP tools

The NeuralSpace MCP server is available at POST /mcp (Streamable HTTP). To work with NS-Image, an agent uses the tools: generate_image, list_models, get_balance. This lets Claude Code, Cursor and other MCP clients use the site models directly.

How to connect

Sign up on NeuralSpace, open the API keys page and create an nsk-… key. Then pass it in the request header or in your MCP client settings. Full documentation is on the the /v1/docs page.

FAQ

Which aspect ratios are available?

auto, 16:9, 9:16, 3:4, 4:3 and 1:1.

Does it support references?

Yes, image-to-image via image_urls.

What is the price per image?

A single price per image.