NS-Image API 与 MCP：如何把图像生成接入你的项目

NS-Image 是NeuralSpace 自有的图像生成模型。NeuralSpace 提供以下模型：NS-Image。它们都通过同一个公开 API 运行，并为 AI 智能体提供了现成的 MCP 服务器。密钥在 API 密钥页面 签发。本文介绍它的能力、请求示例和接入方法。

NS-Image 能做什么

NS-Image 是 NeuralSpace 自有的图像生成模型。每张图统一价格，支持参考图（图生图）以及 auto、16:9、9:16、3:4、4:3 和 1:1 的画面比例。该模型可在网站控制面板、API 和 MCP 中使用。

API 端点

请求发送到 POST /v1/images/generations。示例：{"model": "ns-image", "prompt": "抽象构图", "aspect_ratio": "16:9"}。授权使用请求头 x-api-key 中的 API key。可用的模型 id：ns-image。

MCP 工具

NeuralSpace 的 MCP 服务器位于 POST /mcp（Streamable HTTP）。要使用 NS-Image，智能体调用工具：generate_image, list_models, get_balance。这让 Claude Code、Cursor 等 MCP 客户端能直接使用网站模型。

如何接入

在 NeuralSpace 注册，打开 API 密钥页面 并创建 nsk-… 格式的密钥。然后在请求头或 MCP 客户端设置中传入它。完整文档见 /v1/docs 页面。

常见问题

有哪些画面比例？

auto、16:9、9:16、3:4、4:3 和 1:1。

支持参考图吗？

支持，通过 image_urls 进行图生图。

每张图多少钱？

每张图统一价格。