Сервер MCP

Подключайте Claude Code, Cursor, Codex, VS Code и другие клиенты MCP к моделям изображений и видео SeedRouter с помощью своего API-ключа.

SeedRouter предоставляет удалённый сервер Model Context Protocol. ИИ-агент может использовать его, чтобы получать список моделей изображений и видео, читать схемы их запросов и цены, отправлять задачи на генерацию и забирать результаты, без написания кода интеграции с вашей стороны.

https://api.seedrouter.ai/v1/mcp

Транспорт: Streamable HTTP, без сохранения состояния. Сервер поддерживает версию протокола 2026-07-28 и более ранние версии с начальным рукопожатием initialize, вплоть до 2024-11-05.
Аутентификация: ваш API-ключ SeedRouter как Bearer-токен, Authorization: Bearer YOUR_API_KEY. Создайте его на странице API-ключей; см. раздел Аутентификация.
Тарификация: такая же, как в HTTP API. Каждый вызов submit_task — это один запрос к соответствующему эндпоинту задач, который тарифицируется точно так же.

Клиенты, которые поддерживают только вход через OAuth и не имеют поля для пользовательского заголовка, пока не могут подключиться.

Подключение клиента

На странице API-ключей есть кнопка Подключить через MCP, которая подставляет один из ваших ключей в настройки каждого из перечисленных ниже клиентов.

Claude Code

claude mcp add --transport http seedrouter https://api.seedrouter.ai/v1/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Cursor

Добавьте в ~/.cursor/mcp.json или в .cursor/mcp.json проекта:

{
  "mcpServers": {
    "seedrouter": {
      "url": "https://api.seedrouter.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Codex CLI

Codex считывает ключ из переменной окружения:

export SEEDROUTER_API_KEY=YOUR_API_KEY
codex mcp add seedrouter --url https://api.seedrouter.ai/v1/mcp \
  --bearer-token-env-var SEEDROUTER_API_KEY

Codex сохраняет имя переменной, а не ключ. Запускайте Codex из оболочки, в которой задана SEEDROUTER_API_KEY, например экспортируйте её в профиле оболочки.

VS Code

Добавьте в .vscode/mcp.json:

{
  "servers": {
    "seedrouter": {
      "type": "http",
      "url": "https://api.seedrouter.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Любой другой клиент, поддерживающий удалённые серверы Streamable HTTP с пользовательским заголовком Authorization, настраивается так же.

Инструменты

Инструмент	Назначение	Списание с баланса
`list_models`	Возвращает список ID моделей, которые принимает `submit_task`, со ссылкой на документацию каждой модели. Необязательный `endpoint`: `images` или `videos`.	Нет
`get_model_schema`	Возвращает JSON Schema тела запроса модели. Правила, которые нельзя выразить в JSON Schema, например условные требования и ограничения между полями, проверяются API и описаны на странице документации модели.	Нет
`get_pricing`	Возвращает текущие прейскурантные цены модели в USD из тех же актуальных тарифов, по которым рассчитываются списания, включая все тарифные уровни моделей.	Нет
`submit_task`	Отправляет одну задачу: `model` и `input` — тело запроса, описанное в `get_model_schema`. Возвращает ID задачи.	Да, при каждом вызове, создающем задачу
`get_task`	Возвращает состояние и результат задачи. Необязательный `wait_seconds` (0–50) позволяет ждать на сервере, пока задача ещё выполняется.	Нет
`get_balance`	Возвращает остаток баланса в USD для учётной записи, которой принадлежит ключ.	Нет

submit_task не является идемпотентным. Повторный вызов создаёт вторую задачу и приводит к ещё одному списанию, поэтому перед повторением вызова, результат которого вы не получили, проверьте get_task, get_balance или историю задач.

Типичный порядок действий

Вызовите list_models с endpoint: "images".
Вызовите get_model_schema для выбранной модели.
При необходимости вызовите get_pricing, чтобы заранее узнать тариф.
Вызовите submit_task с model и input, соответствующим схеме.
Вызывайте get_task с wait_seconds: 50, пока status равен processing, затем прочитайте output. Задачи Seedance сообщают queued и running перед succeeded.

Генерация выполняется асинхронно, как и в HTTP API: submit_task возвращает ответ сразу после принятия задачи. wait_seconds избавляет агента от опроса в цикле, но для длинного видео всё равно может потребоваться несколько вызовов get_task. Если во время ожидания проверка состояния не удаётся по временной причине, например из-за ограничения частоты запросов или ошибки сервера, get_task возвращает последний результат processing вместо ошибки; вызовите его снова.

Правила, унаследованные от HTTP API

Референсные изображения, видео и аудио должны передаваться как общедоступные URL http(s). Входные данные в Base64 отклоняются.
Когда HTTP API отвечает, тело его ответа становится результатом инструмента без изменений, с теми же кодами ошибок. Ошибки, возникшие до того, как запрос дошёл до API, например неизвестная модель или неверные аргументы инструмента, возвращаются как обычное сообщение об ошибке. Если ключ отклонён самим эндпоинтом MCP, возвращается HTTP 401.
Неуспешные задачи не тарифицируются.
По умолчанию у одной учётной записи может одновременно выполняться до 50 задач для изображений и видео. Последующие отправки возвращают HTTP 429 с кодом 30002, пока выполняющиеся задачи не завершатся; см. раздел Использование SeedRouter из ИИ-агентов.
ID моделей и параметры совпадают с указанными в документации каждой модели. Модель появляется в list_models, как только становится доступна в API.
Текстовые модели недоступны через MCP. Вызывайте их через текстовые эндпоинты или запускайте на них агента для написания кода, как описано в разделе Агенты для написания кода на SeedRouter.

On this page