# NexGate — полная справка

> Шлюз к API DeepSeek с оплатой в рублях. Base URL: https://nexgate.ru/v1, модель: deepseek-flash. Оплата в рублях. Приём платежей сейчас ручной: заявка в кабинете, зачисление после подтверждения. Чек НПД появится после подключения эквайринга. Подписок нет.

## Для кого

Разработчикам и ИИ-агентам, которым нужен DeepSeek API с российского IP и оплатой в рублях. Ключ работает с российского IP, VPN не нужен.

## Цены

Цены за 1 млн токенов, в рублях. Курс баланса: 1 млн балансовых токенов = 5 ₽.

| Модель | Вход | Кэш | Выход |
|---|---|---|---|
| DeepSeek Flash (deepseek-flash) | 35 ₽ | 5 ₽ | 100 ₽ |

Минимальное пополнение — 100 ₽. Подписок нет: платится за фактически израсходованные токены.

## Как подключить

Меняются два значения: Base URL и API-ключ. Больше ничего.

1. Зарегистрироваться на https://nexgate.ru/register и подтвердить e-mail.
2. Пополнить баланс (от 100 ₽).
3. Создать ключ в кабинете. Формат: `nx_` и 40 hex-символов.
4. В инструменте указать Base URL `https://nexgate.ru/v1` и вставить ключ.

### Cursor

Settings → Models → OpenAI API Key: вставить ключ, в поле Base URL заменить на `https://nexgate.ru/v1`. Модель: `deepseek-flash`.

### Claude Code

```bash
export ANTHROPIC_BASE_URL="https://nexgate.ru/v1"
export ANTHROPIC_AUTH_TOKEN="ВАШ_КЛЮЧ"
```

Claude Code ходит в `/v1/messages` — эндпоинт Anthropic-совместимый.

### Codex CLI

В `~/.codex/config.toml` поменять base_url на `https://nexgate.ru/v1` и задать ключ. Уровень мышления — `model_reasoning_effort`: minimal, low, medium, high.

### Любой OpenAI-совместимый SDK (Python, Node)

```python
from openai import OpenAI

client = OpenAI(
    base_url="https://nexgate.ru/v1",
    api_key="ВАШ_КЛЮЧ",
)
resp = client.chat.completions.create(
    model="deepseek-flash",
    messages=[{"role": "user", "content": "Привет"}],
)
print(resp.choices[0].message.content)
```

```javascript
const OpenAI = require('openai');
const client = new OpenAI({
  baseURL: 'https://nexgate.ru/v1',
  apiKey: 'ВАШ_КЛЮЧ',
});
const r = await client.chat.completions.create({
  model: 'deepseek-flash',
  messages: [{role: 'user', content: 'Привет'}],
});
```

## Эндпоинты

- `https://nexgate.ru/v1/chat/completions` — OpenAI-совместимый чат (POST)
- `https://nexgate.ru/v1/messages` — Anthropic-совместимый чат (POST)
- `https://nexgate.ru/v1/models` — список моделей (GET)
- `https://nexgate.ru/v1/balance` — баланс в токенах и рублях (GET)

Заголовок авторизации: `Authorization: Bearer <ключ>`.

## Модель

`deepseek-flash` — снимок DeepSeek-V4.1-Flash-1017. Контекст 1000K токенов, максимальный ответ 384K токенов. Весь контекст агента помещается в одно окно.

## Режим мышления

Уровень задаёт клиент, шлюз ничего не добавляет. Если инструмент присылает `thinking` или `reasoning_effort` — они уходят в провайдера без изменений.

| Уровень | Что прислать | Когда |
|---|---|---|
| Выключено | `"thinking": {"type": "disabled"}` | простые вопросы, максимум скорости |
| Быстро | `"thinking": {"type": "enabled"}`, `"reasoning_effort": "low"` | обычные правки |
| Обычно | `"thinking": {"type": "enabled"}`, `"reasoning_effort": "high"` | агентские задачи, рекомендуется |
| Глубоко | `"thinking": {"type": "enabled"}`, `"reasoning_effort": "max"` | сложные задачи |

В Codex это `model_reasoning_effort` в `~/.codex/config.toml`, в Claude Code — `MAX_THINKING_TOKENS`. Reasoning-токены тарифицируются как выходные.

## Ошибки

| Код | Что значит | Что делать |
|---|---|---|
| 401 | ключ неверный или отозван | проверить ключ в кабинете |
| 402 | баланс кончился | пополнить; ссылка приходит в теле ответа |
| 429 | превышен лимит частоты | подождать и повторить |
| 502 | ошибка провайдера | деньги за такой запрос не списываются, повторите позже |

## Оплата и баланс

- Баланс в токенах, пополнение в рублях. Курс фиксированный.
- Списывается ровно за фактически израсходованные токены: вход, кэш и выход считаются отдельно.
- Ошибки провайдера не списываются с баланса.
- При исчерпании баланса запрос возвращает 402 со ссылкой на пополнение; остаток не сгорает и хранится без ограничения срока.
- Промпты и ответы не хранятся: только счётчики токенов, стоимость и статус запроса.
- Бесплатный вход: 1000000 токенов на баланс после подтверждения e-mail.

## Где смотреть подробнее

- [Подключение](https://nexgate.ru/docs) — пошаговые настройки под пять инструментов
- [Тарифы](https://nexgate.ru/pricing) — цены и калькулятор пополнения
- [Цены в markdown](https://nexgate.ru/pricing.md) — тот же прайс для парсеров
- [Вопросы и ответы](https://nexgate.ru/faq.md) — коротко о покупке и лимитах
- [Доступ из России](https://nexgate.ru/direct) — что мы берём на себя
- [Статус](https://nexgate.ru/status) — доступность сервиса
- [Оферта](https://nexgate.ru/offer) — условия оказания услуг