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

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

Что умеет Ideogram

Ideogram V3 генерирует изображения по тексту, цена зависит от скорости рендера: TURBO, BALANCED или QUALITY. Модель хорошо работает с текстом и надписями на изображениях, подходит для логотипов, постеров и графики с типографикой.

Эндпоинт API

Запрос отправляется на POST /v1/images/generations. Пример: {"model": "ideogram", "prompt": "логотип в стиле минимализм", "rendering_speed": "QUALITY"}. Авторизация — по API-ключу в заголовке x-api-key. Доступные id моделей: ideogram.

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

MCP-сервер NeuralSpace доступен по адресу POST /mcp (Streamable HTTP). Для работы с Ideogram агент использует инструменты: generate_image, list_models, get_balance. Это позволяет Claude Code, Cursor и другим MCP-клиентам пользоваться моделями сайта напрямую.

Как подключить

Зарегистрируйтесь на NeuralSpace, откройте API-ключей и создайте ключ формата nsk-…. Дальше передавайте его в заголовке запроса или в настройках MCP-клиента. Полная документация — на странице /v1/docs.

Частые вопросы

Какие скорости рендера доступны?

TURBO, BALANCED и QUALITY.

Хорошо ли работает с текстом?

Да, модель сильна в надписях и типографике на изображениях.

Какой формат у запроса?

POST /v1/images/generations с полями model и prompt.