1. СерверTelegram-бот, сайт или внутренний ассистент должны обращаться к MashaGPT API с вашего backend-сервера. Не храните API-ключ в frontend, мобильном приложении или публичном репозитории.

2. МодельОткройте страницу нужной модели и проверьте, какой протокол она поддерживает: Anthropic Messages или OpenAI-compatible.

3. Endpoint

Claude-модели: Base URL https://api.mashagpt.ru, endpoint POST /v1/messages.OpenAI-compatible модели: Base URL https://api.mashagpt.ru/v1, endpoint POST /chat/completions.

4. ОтветВаш сервер получает ответ от MashaGPT API и уже затем отправляет его пользователю в чат, приложение или ваш интерфейс.

Всё, что касается создания, хранения, передачи и отзыва ключей, вынесено в отдельный раздел API-ключи.

Подключение

Base URLhttps://api.mashagpt.ru

Endpoint

POST

/v1/chat/completions

Авторизация

x-api-key: YOUR_API_KEY

илиAuthorization: Bearer YOUR_API_KEY

СовместимостьOpenAI Chat Completions API — только для моделей, где на странице модели указан endpoint /v1/chat/completions

СтримингПоддерживается через stream: true (Server-Sent Events)

Anthropic API и Claude Code

Помимо OpenAI-протокола, API поддерживает протокол Anthropic Messages — к нему подключаются Claude Code, Cursor и любые приложения на Anthropic SDK.

Endpoint

POST

/v1/messages

Base URL

https://api.mashagpt.ruБез «/v1» на конце — Anthropic-клиенты добавляют «/v1/messages» сами

МоделиЛюбой claude-* id автоматически сопоставляется с актуальной моделью: opus → Claude Opus 4.8, sonnet → Claude Sonnet 4.5, haiku → Claude Haiku 4.5. Тарификация — по ценам сопоставленной модели из таблицы цен.

ПоддержкаСтриминг (SSE), системный промпт, изображения, инструменты (tools / tool_use)

Настройка Claude Code (VS Code / CLI)

# Переменные окружения (или поля ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN
# в настройках расширения VS Code):
export ANTHROPIC_BASE_URL="https://api.mashagpt.ru"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"

Пример запроса

curl https://api.mashagpt.ru/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Привет!"}
    ]
  }'

Параметры запроса

model

ID моделиstring, обязательный — например «gpt-5.5», «gemini-3.1-pro-preview»

messages

Массив сообщенийarray, обязательный — роли: system, user, assistant

max_tokens

Максимум токенов в ответеinteger, опционально

temperature

Креативность ответа (0–2)float, опционально — по умолчанию 1

stream

Потоковая передачаboolean, опционально — Server-Sent Events

Маркет API (медиа)

Endpoint

POST

/v1/tasks/{model}

Статус задачи

GET

/v1/tasks/{id}

Генерация изображений, видео, аудио и аватаров выполняется асинхронно. После отправки запроса вы получите id задачи, который можно использовать для проверки статуса через GET /v1/tasks/{id}. Подробнее — в документации каждой модели.

Примеры кода

cURL

curl https://api.mashagpt.ru/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {"role": "system", "content": "Ты полезный ассистент."},
      {"role": "user", "content": "Привет!"}
    ]
  }'

cURL (стриминг)

curl https://api.mashagpt.ru/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "model": "gpt-5.5",
    "stream": true,
    "messages": [
      {"role": "system", "content": "Ты полезный ассистент."},
      {"role": "user", "content": "Привет!"}
    ]
  }'