# SOVAGPT — документация API

SOVAGPT — коммерческий мультипровайдерный ИИ-сервис: ChatGPT, Claude, Gemini, DeepSeek, Perplexity и генерация изображений в одном месте. Есть **OpenAI-совместимое HTTP API** и **MCP-сервер**. Оплата — токенами с баланса аккаунта.

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

1. Зарегистрируйтесь на https://www.sovagpt.ru и создайте API-ключ: Личный кабинет → «API-ключи» → «Создать API-ключ». Ключ (`sk-sova-…`) показывается один раз.
2. Используйте его как обычный OpenAI-ключ, подставив наш Base URL.

- **Base URL:** `https://www.sovagpt.ru/v1`
- **Авторизация:** заголовок `Authorization: Bearer sk-sova-…`
- **Списание:** с баланса токенов владельца ключа.

## Эндпоинты

### GET /v1/models
Актуальный список моделей.

```bash
curl https://www.sovagpt.ru/v1/models -H "Authorization: Bearer sk-sova-…"
```

### POST /v1/chat/completions
OpenAI-совместимый чат (поддерживает `stream: true`).

```bash
curl https://www.sovagpt.ru/v1/chat/completions \
  -H "Authorization: Bearer sk-sova-…" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.5","messages":[{"role":"user","content":"Привет"}]}'
```

### POST /v1/images/generations
Генерация изображений.

```bash
curl https://www.sovagpt.ru/v1/images/generations \
  -H "Authorization: Bearer sk-sova-…" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2","prompt":"рыжий кот на подоконнике","n":1}'
```

### GET /v1/balance
Текущий баланс токенов.

## MCP-сервер

Streamable HTTP, endpoint: `https://www.sovagpt.ru/mcp`. Инструменты: `get_balance`, `chat`, `generate_image`.

**Claude Code:**
```bash
claude mcp add --transport http sovagpt https://www.sovagpt.ru/mcp --header "Authorization: Bearer sk-sova-…"
```

**Claude Desktop** (`claude_desktop_config.json`):
```json
{
  "mcpServers": {
    "sovagpt": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.sovagpt.ru/mcp", "--header", "Authorization: Bearer sk-sova-…"]
    }
  }
}
```

## OpenAI SDK (Python)

```python
from openai import OpenAI
client = OpenAI(base_url="https://www.sovagpt.ru/v1", api_key="sk-sova-…")
r = client.chat.completions.create(model="gpt-5.5",
    messages=[{"role": "user", "content": "Привет"}])
print(r.choices[0].message.content)
```

## Стоимость

Единица оплаты — **токен SOVAGPT**. Базовая цена: **1 токен = 0,1 ₽** (в тарифах при покупке пакетом — дешевле). Списывается по факту, точное число токенов возвращается в ответе.

Ориентировочно (стандартное качество, 1 картинка):
- Вопрос GPT-5.5 — ~10–50 токенов (1–5 ₽), GPT-5.4 mini — ~3 токена
- GPT Image 2 — ~56 токенов (~5,6 ₽)
- Nano Banana — ~89 токенов (~8,9 ₽)
- Nano Banana Pro — ~223 токена (~22 ₽); в максимальном качестве (2K/high) больше
- Генерация в чате блоком ```image рисуется моделью gpt-image-2 (~56 токенов)

Тарифы (месячный пакет токенов, дешевле поштучной цены): Базовый 990 ₽ / 10 000 ток., Стандарт 2 590 ₽ / 27 000, Премиум 4 990 ₽ / 52 500, Ультра 9 900 ₽ / 110 000. Актуальные цены: https://www.sovagpt.ru → Тарифы.

## Модели чата

- `gpt-5.5` — GPT-5.5
- `gpt-5.4` — GPT-5.4
- `gpt-5.4-mini` — GPT-5.4 mini
- `gpt-5.1` — GPT-5.1
- `gpt-5` — GPT-5
- `gpt-5-mini` — GPT-5 mini
- `gpt-5-nano` — GPT-5 nano
- `gpt-4.1` — GPT-4.1
- `gpt-4.1-mini` — GPT-4.1 mini
- `o3` — o3
- `o4-mini` — o4-mini
- `o3-mini` — o3-mini
- `gpt-4o` — GPT-4o
- `gpt-4o-mini` — GPT-4o mini
- `gemini-3.5-flash` — Gemini 3.5 Flash
- `gemini-3.1-pro-preview` — Gemini 3.1 Pro
- `gemini-2.5-pro` — Gemini 2.5 Pro
- `gemini-2.5-flash` — Gemini 2.5 Flash
- `claude-opus-4-8` — Claude Opus 4.8
- `claude-opus-4-7` — Claude Opus 4.7
- `claude-opus-4-6` — Claude Opus 4.6
- `claude-sonnet-4-6` — Claude Sonnet 4.6
- `claude-haiku-4-5` — Claude Haiku 4.5
- `claude-fable-5` — Claude Fable 5
- `deepseek-v4-flash` — DeepSeek V4 Flash
- `deepseek-v4-pro` — DeepSeek V4 Pro
- `deepseek-v3.2` — DeepSeek V3.2
- `deepseek-r1` — DeepSeek R1
- `deepseek-chat` — DeepSeek Chat
- `sonar-pro` — Sonar Pro
- `sonar-reasoning-pro` — Sonar Reasoning Pro
- `sonar` — Sonar

## Модели изображений

- `gemini-3-pro-image` — Nano Banana Pro
- `gpt-image-2` — GPT Image 2
- `gemini-3.1-flash-image` — Nano Banana
- `doubao-seedream-4-5-251128` — SEEDREAM 4.5
- `grok-imagine-image` — Grok Imagine
- `gpt-image-2-lite` — GPT Image 2 Lite
- `grok-4.2-image` — Grok Image
- `kling-image-o1` — Kling Omni-Image
- `doubao-seedream-5-0-260128` — SEEDREAM 5
- `google/gemini-3-pro-image` — Nano Banana Pro (OR)
- `openai/gpt-5-image` — GPT-5 Image (OR)

## См. также

- Этот же документ в Markdown: https://www.sovagpt.ru/docs.md
- Веб-версия (HTML): https://www.sovagpt.ru/docs
- Краткая сводка для ИИ: https://www.sovagpt.ru/llms.txt
- Машинночитаемая спека: https://www.sovagpt.ru/openapi.json