Подключение

Совместимо с OpenAI: в коде меняются две строки

Совместимо с OpenAI: в коде меняются две строки — адрес сервера и ключ. Библиотека, формат запроса и счётчик токенов остаются теми же. Потокового ответа пока нет: с stream: true запрос отвечает ошибкой и денег не берёт.

1

Получите ключ

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

2

Замените адрес и ключ

Вместо api.openai.com/v1 подставьте https://gpt.nls.kz/v1, вместо своего ключа — выданный.

3

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

Поле model можно не заполнять — ответит NLSGPT 1. Чужие имена возьмите из каталога ниже.

Примеры

Один и тот же запрос на трёх языках

curl
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. Нужна чужая — подставьте её id. Цены в тенге на странице «Модели и цены».

Модель id для «model» Для чего Контекст
NLSGPT 1
наша · отвечает без выбора модели
nlsgpt-1 Наша модель: казахский язык, законы РК и справочники 131K
GPT-5.6 Sol gpt-5.6-sol Флагман OpenAI: сложные задачи, анализ, код 1,1M
GPT-5.6 Luna gpt-5.6-luna Быстро и дёшево для потоковых задач 1,1M
Gemini 3.7 Flash gemini-3.7-flash Быстрые ответы на большом объёме текста 1M
Qwen3.8 Max qwen3.8-max Флагман Qwen: сильный китайский и английский, недорогой выход 1M
DeepSeek V4 Pro deepseek-v4-pro Качество уровня флагманов за треть цены 1M
DeepSeek V4 Flash deepseek-v4-flash Самый дешёвый вариант, где качества хватает 1,3M
Продукты

Продукт вместо модели: платите за результат

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

Проверить текст на ошибки · Тело запроса: JSON, поле `lines`

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

Машинное описание — без ключа

Модель, которая пишет ваш код, читает эти три адреса сама. Ключ им не нужен.

Описание всех ручек в OpenAPI
https://gpt.nls.kz/openapi.json
То же самое словами, для модели
https://gpt.nls.kz/llms.txt
Инструменты MCP: один POST, JSON-RPC 2.0
https://gpt.nls.kz/mcp
Ответы

Что ответит сервер, когда что-то не так

Номера карт маскируем. Если в запросе оказался номер банковской карты, сервис заменит его на «**** **** **** 1234» прежде, чем отдать модели. Остальной текст уходит как есть: ИИН и телефоны в договоре — это работа, и решать за вас мы не будем.
Если модель не отвечает, сервис повторяет запрос сам и только потом возвращает 503 — без списания. Модель при этом не подменяется: вы назвали её в поле model. В чате рабочего места правило другое — там сотрудник выбирает режим, поэтому ответить может резервная, и под ответом об этом написано.
У любой ошибки тело одинаковое: {"error": {"code": "...", "message": "..."}}. Сообщение написано человеку, его можно показать как есть.
До 120 запросов в минуту на ключ. Нет денег — 402, лимит исчерпан — 429, продукт закрыт — 410 с названием замены.
Тела запросов и ответы моделей не сохраняются: в учёте остаются только метаданные.
Коды ответа

Что придёт вместо ответа, если что-то не так

Код всегда приходит с текстом: какой именно лимит сработал, кто отключил модель, когда обнулится счётчик. Искать причину в журнале не нужно.

Код Что произошло
200 Ответ получен, стоимость списана с баланса
401 Ключ неверный или отозван
402 Закончился баланс. Запрос не выполнялся, деньги не списаны
403 Модель отключена администратором компании — или ключ работает только с разрешённых адресов, а запрос пришёл с другого. Что именно, написано в тексте ошибки
429 Исчерпан лимит ключа или компании. В тексте — какой и когда обнулится
503 Модель временно недоступна. Деньги не списаны, можно повторить

Ключ — в пяти минутах от регистрации

Зарегистрируйте компанию, выставьте себе счёт и создайте ключ — всё в кабинете, без менеджера.