samreshuuu API

Интегрируйте AI-возможности в ваш продукт: генерация текста, агенты, обработка документов и автоматизация задач.

Интеграция говорит с Сам Решу через две двери, обе открывает ключ организации (sk-org-…):

OpenAI-совместимый API по адресу https://samreshuuu.ru/v1: чат с вашими агентами, model это хэндл агента;
MCP-сервер по адресу https://samreshuuu.ru/mcp/: подключённые сервисы и выполнение кода для вашего агента или IDE.

Что может ключ, задают его скоупы, см. Аутентификация. Нативный /api/v1 это внутренний API приложений Сам Решу, а не контракт для интеграций.

Начало работы

Выпустите ключ

Откройте Настройки → API-ключи, создайте ключ с Полным доступом и сохраните его в переменной окружения:

export SAMRESHUUU_API_KEY="sk-org-your_api_key"

Выберите агента

GET /v1/models перечисляет агентов, с которыми может говорить ваша организация, первым встроенный ассистент (samreshu). id записи это хэндл агента, тот же @handle, что в приложении.

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

Отправьте сообщение

Python

Node.js

cURL

import os from openai import OpenAI client = OpenAI(api_key=os.environ["SAMRESHUUU_API_KEY"], base_url="https://samreshuuu.ru/v1") stream = client.chat.completions.create( model="samreshu", messages=[{"role": "user", "content": "Дай три коротких совета, как назвать карточку товара на маркетплейсе"}], stream=True, ) for chunk in stream: print(chunk.choices[0].delta.content or "", end="")

Агент отвечает со своими инструкциями, моделью, коннекторами и навыками. Формат чанков и события инструментов описаны в разделе Стриминг.

Карта разделов

Аутентификация: ключи sk-org-…, скоупы, ротация, ошибки 401/403
OpenAI-совместимый API и MCP: две двери для интеграций
Стриминг, Агенты, Выполнение кода, Коннекторы, Ошибки и лимиты

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

Нужен ли SDK для работы с API samreshuuu?

Нет. API совместим с OpenAI: OpenAI SDK работает после замены base URL, обычный HTTP с Server-Sent Events тоже подходит. Подключённые сервисы и выполнение кода доступны через MCP-сервер с тем же ключом.

Как запустить ход и прочитать ответ?

POST /v1/chat/completions, в model хэндл агента из GET /v1/models. С stream: true ответ читается по мере написания.

Как устроен base URL?

API для интеграций находится по адресу https://samreshuuu.ru/v1, MCP-сервер по адресу https://samreshuuu.ru/mcp/. Оба принимают ключ организации (sk-org-...).