# NLSGPT

> Своя ИИ-модель и готовые продукты для казахстанского бизнеса: оплата в тенге, договор по местному праву, закрывающие документы. По умолчанию отвечает модель nlsgpt-1; чужие модели доступны, когда их называют явно. Один ключ на модель и на все продукты.

Ключ выдаётся в кабинете после первой оплаты и передаётся заголовком `Authorization: Bearer nlsgpt-…`. Машинное описание: [OpenAPI](https://gpt.nls.kz/openapi.json).

Из редактора удобнее через MCP: `https://gpt.nls.kz/mcp`, тот же ключ. Продукты появятся инструментами, новые — сами, без правок на вашей стороне.

```json
{
  "mcpServers": {
    "nlsgpt": {
      "url": "https://gpt.nls.kz/mcp",
      "headers": {
        "Authorization": "Bearer $NLSGPT_KEY"
      }
    }
  }
}
```

## Запросы к модели

Совместимо с OpenAI: в любой библиотеке достаточно подменить адрес — `base_url = "https://gpt.nls.kz/v1"`, ключ ваш. Поле `model` необязательно: без него отвечает `nlsgpt-1`. Чужая модель отвечает, только если названа явно. Список моделей — `GET https://gpt.nls.kz/v1/models`, ответ в том же формате, что у OpenAI.

Потокового ответа нет: с `stream: true` запрос отвечает 400 `streaming_not_supported`, деньги не списываются. Ответ приходит целиком, одним объектом.

```
curl https://gpt.nls.kz/v1/chat/completions \
  -H "Authorization: Bearer $NLSGPT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","content":"Привет"}]}'
```

- `nlsgpt-1` — Наша модель: казахский язык, законы РК и справочники. Вход 200 ₸, выход 600 ₸ за миллион токенов. Отвечает, когда model не назван.
- `gpt-5.6-sol` — Флагман OpenAI: сложные задачи, анализ, код. Вход 1 697 ₸, выход 8 487 ₸ за миллион токенов.
- `gpt-5.6-luna` — Быстро и дёшево для потоковых задач. Вход 169 ₸, выход 1 018 ₸ за миллион токенов.
- `gemini-3.7-flash` — Быстрые ответы на большом объёме текста. Вход 318 ₸, выход 1 591 ₸ за миллион токенов.
- `qwen3.8-max` — Флагман Qwen: сильный китайский и английский, недорогой выход. Вход 1 697 ₸, выход 5 092 ₸ за миллион токенов.
- `deepseek-v4-pro` — Качество уровня флагманов за треть цены. Вход 351 ₸, выход 702 ₸ за миллион токенов.
- `deepseek-v4-flash` — Самый дешёвый вариант, где качества хватает. Вход 67 ₸, выход 152 ₸ за миллион токенов.

## Продукты

Клиент платит за результат, а не за токены. Какой моделью выполнить — решает NLSGPT: где справляется своя, работает своя.

Запуск синхронный и платный, поэтому повтор опасен. Пришлите `Idempotency-Key` с UUID — второй запрос с тем же ключом не выполняется и не списывается, а отвечает 409 с кодом `duplicate_request` и полями `event`, `units`, `charged_tenge` для сверки. Ответ первого запроса не хранится: строки клиента живут только в его ответе. Без заголовка поведение прежнее — два запроса это два запуска.

- [Durys](https://gpt.nls.kz/durys) — проверить текст на ошибки. `POST /v1/durys`, JSON, поле `lines`. 2 500 ₸ за 1 000 строк.
- [Esep](https://gpt.nls.kz/esep) — разобрать счёт или накладную. `POST /v1/esep`, multipart, поле `files[]`. 50 ₸ за документ.
- [Meken](https://gpt.nls.kz/meken) — привести адреса к единому виду. `POST /v1/meken`, JSON, поле `lines`. 2 500 ₸ за 1 000 записей.
- [Tilmash](https://gpt.nls.kz/tilmash) — перевести на казахский. `POST /v1/tilmash`, JSON, поле `lines`. 2 500 ₸ за 1 000 строк.
- [Tyndau](https://gpt.nls.kz/tyndau) — расшифровать запись в текст. `POST /v1/tyndau`, multipart, поле `file`. 9 ₸ за минуту записи.

Строки уходят JSON-ом — так работает любой продукт над строками:

```
curl https://gpt.nls.kz/v1/durys \
  -H "Authorization: Bearer $NLSGPT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lines":["Уведомляем вас о том что оплата произведенна"]}'
```

Запись уходит файлом, до 25 МБ:

```
curl https://gpt.nls.kz/v1/tyndau \
  -H "Authorization: Bearer $NLSGPT_KEY" \
  -F file=@zapis.m4a
```

Документы уходят пачкой, до 5 за раз:

```
curl https://gpt.nls.kz/v1/esep \
  -H "Authorization: Bearer $NLSGPT_KEY" \
  -F "files[]=@schet.pdf" -F "files[]=@nakladnaya.jpg"
```

## Что нужно знать

- Тела запросов и ответы моделей не сохраняются: в учёте остаются только метаданные.
- Деньги списываются по факту; нет денег — 402, лимит исчерпан — 429, продукт закрыт — 403.
- Закрытый продукт отвечает 410 и называет замену, а не исчезает в 404.
- Частота — до 120 запросов в минуту на ключ; сверх этого 429 с объяснением по-русски.
- Ключ можно ограничить списком адресов в кабинете: запрос с чужого — 403 с указанием адреса.
- У любой ошибки тело одинаковое: `{"error": {"code": "...", "message": "..."}}`, сообщение написано человеку и его можно показать как есть.