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

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

Что умеет Seedream

Seedream генерирует изображения по тексту. 4.5 и 5 Lite имеют единую цену за картинку, 5 Pro тарифицируется по качеству basic (1K) и high (2K). 5 Lite работает только в режиме text-to-image, а Pro поддерживает более высокое качество.

Эндпоинт API

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

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

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

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

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

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

Чем 5 Pro отличается от 5 Lite?

5 Pro поддерживает качество high (2K), 5 Lite — только text-to-image.

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

У 5 Pro — basic (1K) и high (2K).

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

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