← Все статьи

NS-Image API и MCP: как подключить генерацию изображений к своему проекту

Светящийся куб с абстрактными гранями

NS-Image — собственная модель генерации изображений NeuralSpace. На NeuralSpace доступны модели: NS-Image. Все они работают через единый публичный API, а для ИИ-агентов есть готовый MCP-сервер. Ключ выдаётся на странице API-ключей. Ниже — возможности модели, примеры запросов и способ настройки.

Что умеет NS-Image

NS-Image — собственная модель NeuralSpace для генерации изображений. Единая цена за картинку, поддержка референсов (image-to-image) и соотношений сторон 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"}. Авторизация — по API-ключу в заголовке x-api-key. Доступные id моделей: ns-image.

Светящийся куб с гранями

MCP-инструменты

MCP-сервер NeuralSpace доступен по адресу 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-to-image через image_urls.

Какая цена за картинку?

Единая цена за изображение.