Интерактивный API-эксплорер

Публичная схема для разработчиков содержит HTTP-поверхность для интеграций, 2 операции (POST /v1/chat/completions и GET /v1/models): их можно просмотреть и вызвать прямо в браузере, схема генерируется из живой OpenAPI-спеки и следует опубликованному коду.

Эксплорер: samreshuuu.ru/api/v1/developers/docs
OpenAPI-спека: samreshuuu.ru/api/v1/developers/openapi.json

Авторизация

Каждая операция принимает ключ организации (sk-org-…) и называет нужный scope в своём security (OrgApiKey: ["chat:write"]). На токен вошедшего пользователя операция отвечает 401 AUTH_TOKEN_INVALID. См. Аутентификация:

curl https://samreshuuu.ru/v1/models \ -H "Authorization: Bearer $SAMRESHUUU_API_KEY"

Запросы из эксплорера идут в боевой API с вашим ключом и запускают настоящие ходы за счёт вашей квоты. Отсутствующий или неверный ключ возвращает 401; ключ без chat:write получает 403 AUTH_PERMISSION_DENIED. Полный контракт статус-кодов и кодов ошибок описан в разделе Ошибки и лимиты.

Сгенерировать клиент

Спека в стандартном формате OpenAPI 3, передайте её любому генератору, чтобы получить типизированный клиент.

npx @openapitools/openapi-generator-cli generate \ -i https://samreshuuu.ru/api/v1/developers/openapi.json \ -g typescript-fetch \ -o ./samreshuuu-client

Та же спека работает с любым OpenAPI-совместимым тулчейном: поменяйте цель -g на python, go, java и так далее, либо направьте инструменты вроде openapi-typescript прямо на URL.

Что входит в публичную поверхность

Спека охватывает только OpenAI-совместимый API. Подключённые сервисы и выполнение кода не доступны через REST: обращайтесь к ним через агента в чате или напрямую инструментами MCP-сервера. Нативный /api/v1 приложений Сам Решу в публичную поверхность не входит.

Лимиты вкратце

Ключи организации имеют поминутный лимит на каждый ключ по тарифу:

Тариф	Запросов в минуту на ключ
Pro	180
Max	360

Лимиты могут меняться; актуальные значения на странице тарифов. При известной задержке отказ содержит Retry-After; заголовков X-RateLimit-* API не отдаёт. Исчерпанный недельный лимит отвечает 402, его не повторяют. Полное руководство по повторным попыткам находится в разделе Ошибки и лимиты.

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

Что охватывает интерактивный API-эксплорер?

HTTP-поверхность для интеграций: POST /v1/chat/completions и GET /v1/models, их можно просмотреть и вызвать в браузере. Она генерируется из живой OpenAPI-спеки для разработчиков, поэтому следует опубликованной схеме. Подключённые сервисы и выполнение кода доступны через MCP, а не REST.

Как авторизовать запрос?

Передайте Authorization: Bearer sk-org-... Каждая операция в спеке называет scope, нужный ключу; обе требуют chat:write, и ключ без него получает 403 AUTH_PERMISSION_DENIED.

Можно ли сгенерировать типизированный клиент из API?

Да. Спека по адресу /api/v1/developers/openapi.json в стандартном формате OpenAPI 3, передайте её любому генератору (openapi-generator, openapi-typescript и другим), чтобы получить типизированный клиент на вашем языке.

Есть ли лимиты на API?

Да. Лимит каждого ключа зависит от тарифа организации, таблица есть на этой странице. При известной задержке отказ содержит Retry-After. Полный контракт описан в разделе «Ошибки и лимиты».