# CoreMind API

> Публичный API и MCP-сервер CoreMind: генерация изображений, видео и музыки через REST и MCP, вход по API-ключу или OAuth.

MCP-сервер доступен по адресу https://api.coremind.ru/mcp. Маршруты REST и их базовый адрес описаны в openapi.json.

## Документация

- [Справочник API — CoreMind](https://coremind.ru/docs/api): Полный справочник публичного API CoreMind: маршруты, параметры, схемы ответов и коды отказов.
- [openapi.json](https://coremind.ru/docs/api/openapi.json): машиночитаемое описание OpenAPI для каждого маршрута публичного API.
- [Быстрый старт с API — CoreMind](https://coremind.ru/docs/api/quickstart): Первые вызовы публичного API CoreMind: проверка ключа, аккаунт, каталог моделей и чтение генераций.
- [Аутентификация в API — CoreMind](https://coremind.ru/docs/api/authentication): Как подписать запрос к публичному API CoreMind: заголовок Authorization, свойства ключа и области доступа.
- [MCP-сервер — CoreMind](https://coremind.ru/docs/api/mcp): Как подключить CoreMind к Claude, Cursor, Codex и другим MCP-клиентам: адрес, ключ, инструменты, генерация и лимиты.
- [Идемпотентность API — CoreMind](https://coremind.ru/docs/api/idempotency): Заголовок Idempotency-Key в публичном API CoreMind: что идентифицирует ключ, что возвращает повтор и когда запрос отклоняется как конфликт.
- [Лимиты и квоты API — CoreMind](https://coremind.ru/docs/api/limits): Частота запросов, постраничный вывод и кеширование публичного API CoreMind.
- [Коды ошибок API — CoreMind](https://coremind.ru/docs/api/error-codes): Форма ответа об ошибке публичного API CoreMind и полный список кодов с их HTTP-статусами.

## Optional

- [OAuth для приложений — CoreMind](https://coremind.ru/docs/api/oauth): Как приложение получает доступ к публичному API CoreMind от имени пользователя: discovery, регистрация клиента, код авторизации с PKCE, ротация refresh-токенов и отзыв.
- [События (SSE) — CoreMind API](https://coremind.ru/docs/api/events): Поток событий GET /v1/events в публичном API CoreMind: смена статуса генераций в реальном времени, переподключение по Last-Event-ID без потерь, кадры reset и terminated, лимиты потока.
- [Цепочки (workflows) — CoreMind API](https://coremind.ru/docs/api/workflows): Публичный API для цепочек canvas-редактора: хранение чертежа, блоки, запуск, оценка цены и повтор шага итератора.