MMashaGPT API
MMashaGPT API
МоделиДокументацияТестированиеAPI-ключиПлатежи
МоделиДокументацияТестированиеAPI-ключиПлатежи
API-ключиЗагрузка файлов
IDE-интеграции
CursorClaude CodeOpenCodeVS CodeCodex
Nano Banana 2POSTNano Banana ProPOST
Black ForestPOST
Seedream 5.0 Pro Text-to-ImagePOSTSeedream 5.0 Pro Image-to-ImagePOSTSeedream 5.0 Lite Text-to-ImagePOSTSeedream 5.0 Lite Image-to-ImagePOST
Grok Imagine Text-to-ImagePOSTGrok Imagine Image-to-ImagePOSTGrok Imagine Image 2.0 Text-to-ImagePOSTGrok Imagine Image 2.0 Image EditPOST
Qwen3 Text-to-ImagePOSTQwen3 Pro Text-to-ImagePOSTQwen3 Image-to-ImagePOSTQwen3 Pro Image-to-ImagePOST
Z-ImagePOST
GPT Image 2 Text-to-ImagePOSTGPT Image 2 Image-to-ImagePOSTGPT Image 2.5 Flare Text-to-ImagePOSTGPT Image 2.5 Flare Image-to-ImagePOSTGPT Image 2.5 Sunburst Text-to-ImagePOSTGPT Image 2.5 Sunburst Image-to-ImagePOST
QwenPOSTCodePlugTechPOST
TikTokPOST
Hailuo 2.3POSTMiniMax Hailuo 03 Text-to-VideoPOSTMiniMax Hailuo 03 Image-to-VideoPOSTMiniMax Hailuo 03 Reference-to-VideoPOSTMiniMax Video 01 DirectorPOST
Kling V2.5 Turbo Text-to-Video ProPOSTKling V2.5 Turbo Image-to-Video ProPOSTKling 2.6 Text-to-VideoPOSTKling 2.6 Image-to-VideoPOSTKling 3.0 Text-to-VideoPOSTKling 3.0 Omni Text-to-VideoPOSTKling 3.0 Omni Image-to-VideoPOSTKling 3.0 Omni Reference-to-VideoPOSTKling 3.0 Omni TransformationPOSTKling 3.0 Turbo Text-to-VideoPOSTKling 3.0 Turbo Image-to-VideoPOST
Veo 3.1POSTVeo 3.1 LitePOSTGemini Omni VideoPOST
Grok Imagine Video 1.5 PreviewPOSTGrok Imagine Text-to-VideoPOSTGrok Imagine Image-to-VideoPOST
HappyHorse 1.0 Text-to-VideoPOSTHappyHorse 1.0 Image-to-VideoPOSTHappyHorse 1.0 Reference-to-VideoPOSTHappyHorse 1.0 Video EditPOSTHappyHorse 1.1 Text-to-VideoPOSTHappyHorse 1.1 Image-to-VideoPOSTHappyHorse 1.1 Reference-to-VideoPOSTPixVerse v6 Text-to-VideoPOSTPixVerse v6 Image-to-VideoPOSTPixVerse v6 TransitionPOSTPixVerse v6 Reference-to-VideoPOSTPixVerse v6 ExtendPOST
Seedance V1.5 ProPOSTSeedance 2.0 Text-to-VideoPOSTSeedance 2.5 Text-to-VideoPOSTSeedance 2.0 MiniPOST
TopazPOST
ElevenLabs TTS Multilingual V2POSTElevenLabs TTS Turbo V2.5POSTElevenLabs TTS Flash V2.5POSTElevenLabs TTS V3POSTElevenLabs DubbingPOSTElevenLabs Sound Effect V2POSTElevenLabs Text-to-Dialogue V3POST
Gemini 3.1 Flash TTSPOSTGemini 2.5 Pro Preview TTSPOST
Kling 3.0 Motion ControlPOSTKling V1 Avatar ProPOSTKling V1 Avatar StandardPOST
xAIPOSTOpenAIPOST
Claude Sonnet 5POSTClaude Opus 4.8POSTClaude Opus 5.5POSTClaude Sonnet 5.5POST
DeepSeekPOSTGooglePOST

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

Быстрый старт

1Создайте ключ

Перейдите во вкладку «Ключи» и создайте новый API ключ

2Пополните баланс

Пополните баланс в рублях во вкладке «Оплата»

3Отправьте запрос

Выберите модель и отправьте запрос с вашего сервера

Если вы делаете своего бота

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 и приложения на Anthropic SDK. Возможности конкретного редактора проверяйте в разделе IDE-интеграций.

Endpoint
POST
/v1/messages
Base URL
https://api.mashagpt.ruБез «/v1» на конце — Anthropic-клиенты добавляют «/v1/messages» сами
МоделиИспользуйте точный API ID из актуального каталога моделей MashaAPI. Произвольные claude-* ID и алиасы API не сопоставляет с другой моделью. Тарификация соответствует запрошенному ID в каталоге. Для Claude Code настройте алиасы в settings.json по инструкции в разделе IDE-интеграций.
ПоддержкаСтриминг (SSE), системный промпт, изображения, инструменты (tools / tool_use)
Настройка Claude Code (VS Code / CLI)
# Для запуска Claude Code из этого терминала:
export ANTHROPIC_BASE_URL="https://api.mashagpt.ru"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export ANTHROPIC_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-sonnet-5"
Пример запроса
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": "Привет!"}
    ]
  }'
Документация
API-ключиЗагрузка файлов
IDE-интеграции
CursorClaude CodeOpenCodeVS CodeCodex
Nano Banana 2POSTNano Banana ProPOST
Black ForestPOST
Seedream 5.0 Pro Text-to-ImagePOSTSeedream 5.0 Pro Image-to-ImagePOSTSeedream 5.0 Lite Text-to-ImagePOSTSeedream 5.0 Lite Image-to-ImagePOST
Grok Imagine Text-to-ImagePOSTGrok Imagine Image-to-ImagePOSTGrok Imagine Image 2.0 Text-to-ImagePOSTGrok Imagine Image 2.0 Image EditPOST
Qwen3 Text-to-ImagePOSTQwen3 Pro Text-to-ImagePOSTQwen3 Image-to-ImagePOSTQwen3 Pro Image-to-ImagePOST
Z-ImagePOST
GPT Image 2 Text-to-ImagePOSTGPT Image 2 Image-to-ImagePOSTGPT Image 2.5 Flare Text-to-ImagePOSTGPT Image 2.5 Flare Image-to-ImagePOSTGPT Image 2.5 Sunburst Text-to-ImagePOSTGPT Image 2.5 Sunburst Image-to-ImagePOST
QwenPOSTCodePlugTechPOST
TikTokPOST
Hailuo 2.3POSTMiniMax Hailuo 03 Text-to-VideoPOSTMiniMax Hailuo 03 Image-to-VideoPOSTMiniMax Hailuo 03 Reference-to-VideoPOSTMiniMax Video 01 DirectorPOST
Kling V2.5 Turbo Text-to-Video ProPOSTKling V2.5 Turbo Image-to-Video ProPOSTKling 2.6 Text-to-VideoPOSTKling 2.6 Image-to-VideoPOSTKling 3.0 Text-to-VideoPOSTKling 3.0 Omni Text-to-VideoPOSTKling 3.0 Omni Image-to-VideoPOSTKling 3.0 Omni Reference-to-VideoPOSTKling 3.0 Omni TransformationPOSTKling 3.0 Turbo Text-to-VideoPOSTKling 3.0 Turbo Image-to-VideoPOST
Veo 3.1POSTVeo 3.1 LitePOSTGemini Omni VideoPOST
Grok Imagine Video 1.5 PreviewPOSTGrok Imagine Text-to-VideoPOSTGrok Imagine Image-to-VideoPOST
HappyHorse 1.0 Text-to-VideoPOSTHappyHorse 1.0 Image-to-VideoPOSTHappyHorse 1.0 Reference-to-VideoPOSTHappyHorse 1.0 Video EditPOSTHappyHorse 1.1 Text-to-VideoPOSTHappyHorse 1.1 Image-to-VideoPOSTHappyHorse 1.1 Reference-to-VideoPOSTPixVerse v6 Text-to-VideoPOSTPixVerse v6 Image-to-VideoPOSTPixVerse v6 TransitionPOSTPixVerse v6 Reference-to-VideoPOSTPixVerse v6 ExtendPOST
Seedance V1.5 ProPOSTSeedance 2.0 Text-to-VideoPOSTSeedance 2.5 Text-to-VideoPOSTSeedance 2.0 MiniPOST
TopazPOST
ElevenLabs TTS Multilingual V2POSTElevenLabs TTS Turbo V2.5POSTElevenLabs TTS Flash V2.5POSTElevenLabs TTS V3POSTElevenLabs DubbingPOSTElevenLabs Sound Effect V2POSTElevenLabs Text-to-Dialogue V3POST
Gemini 3.1 Flash TTSPOSTGemini 2.5 Pro Preview TTSPOST
Kling 3.0 Motion ControlPOSTKling V1 Avatar ProPOSTKling V1 Avatar StandardPOST
xAIPOSTOpenAIPOST
Claude Sonnet 5POSTClaude Opus 4.8POSTClaude Opus 5.5POSTClaude Sonnet 5.5POST
DeepSeekPOSTGooglePOST