Внешний API

Какие интерфейсы EVA открывает наружу: OpenAI-совместимый API, MCP-шлюз, MCP для IDE, OpenAPI-документация и npm-реестр. Для тех, кто интегрирует EVA со своими системами.

/v1

OpenAI-совместимый API

Модели платформы для скриптов, CI и приложений. Учёт и лимиты как в чате.

MCP

MCP-шлюз /mcp

Инструменты выбранных MCP-источников для внешних агентов и IDE по API-ключу.

IDE

MCP /mcp/eva-packages

Разработка пакетов из IDE в локальном режиме.

DOC

OpenAPI /api/docs

Интерактивная документация всего REST API платформы.

NPM

npm-реестр

Пакеты SDK @eva/* для установки зависимостей пакетов.

OpenAI-совместимый API

Авторизация: Authorization: Bearer <API-ключ>. Только в облачном режиме.

Метод	Путь	Что делает
GET	`/v1/models`	Модели, доступные роли владельца ключа, с окном контекста
POST	`/v1/chat/completions`	Прозрачный прокси к провайдеру модели
POST	`/v1/responses`	То же для Responses API, если режим модели позволяет

Что делает шлюз:

проверяет ключ, права и месячный лимит до обращения к провайдеру;
подставляет идентификатор модели у провайдера;
передаёт запрос и ответ как есть, включая tools и потоковый режим;
в потоковых запросах Chat Completions добавляет stream_options.include_usage, чтобы получить расход;
пишет расход в журнал без привязки к чату.

Шлюз не создаёт чат и не подключает MCP, файлы и правила. Для агентной работы с инструментами используйте чат или агентов.

python

from openai import OpenAI

client = OpenAI(base_url="https://eva.example.com/v1", api_key="eva_...")
reply = client.chat.completions.create(
    model="<идентификатор у провайдера>",
    messages=[{"role": "user", "content": "Составь план релиза"}],
)
print(reply.choices[0].message.content)

MCP-шлюз

POST, GET, DELETE на /mcp по протоколу Streamable HTTP с сессией. Авторизация тем же API-ключом.

POST /mcp с initialize, в ответе заголовок mcp-session-id.
Дальше tools/list и tools/call с этим заголовком.

Видны инструменты источников, которые включены, помечены «Доступен для проксирования» и выбраны в ключе.

json

{
  "mcpServers": {
    "eva": {
      "url": "https://eva.example.com/mcp",
      "headers": { "Authorization": "Bearer eva_..." }
    }
  }
}

OpenAPI

Полное описание REST API платформы с примерами доступно по адресу /api/docs. Документация открывается из браузера под вашей сессией и показывает только то, что вам разрешено.

npm-реестр

API отдаёт пакеты SDK @eva/* по адресу /npm-registry и проксирует остальные пакеты на upstream. Его использует установка зависимостей пакетов. Подробнее: Пакеты и рантайм.

Внешний API ​

OpenAI-совместимый API ​

MCP-шлюз ​

OpenAPI ​

npm-реестр ​

Внешний API

OpenAI-совместимый API

MCP-шлюз

OpenAPI

npm-реестр