Документация

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

Три шага. После первого у вас есть ключ, после третьего — ответ модели.

1. 1. Создайте организацию

   Одна форма, письма ждать не нужно: /ru/signup. Сразу даётся 100 000 токенов в месяц.

2. 2. Выпустите ключ

   В портале: «Разработчикам» → «Ключи API» → «Новый ключ». Ключ показывается один раз.

3. 3. Сделайте запрос

   curl https://router.tilqazyna.kz/v1/chat/completions \
     -H "Authorization: Bearer $TQ_KEY" \
     -H "Content-Type: application/json" \
     -d '{"model":"qwen","messages":[{"role":"user","content":"Сәлем!"}]}'

Быстрый старт для вайбкодинга

Если вы пишете код вместе с ИИ-агентом, дайте ему это. Дальше он разберётся сам.

Используй OpenAI-совместимый API: base_url https://router.tilqazyna.kz/v1, ключ в переменной TQ_KEY, model "qwen". Описание для агентов: https://router.tilqazyna.kz/llms.txt

from openai import OpenAI

client = OpenAI(
    base_url="https://router.tilqazyna.kz/v1",
    api_key=os.environ["TQ_KEY"],
)

answer = client.chat.completions.create(
    model="qwen",
    messages=[{"role": "user", "content": "Сәлем!"}],
)
print(answer.choices[0].message.content)

import OpenAI from 'openai';

const client = new OpenAI({
    baseURL: 'https://router.tilqazyna.kz/v1',
    apiKey: process.env.TQ_KEY,
});

const answer = await client.chat.completions.create({
    model: 'qwen',
    messages: [{ role: 'user', content: 'Сәлем!' }],
});

Подключение

Base URL

https://router.tilqazyna.kz/v1

Авторизация

Authorization: Bearer sk-tq-… — ключ создаётся в портале

Формат

JSON, UTF-8. Ошибки — в формате OpenAI

Модели

Имена моделей Qazgramma

Задача едет в имени модели. Части можно ставить в любом порядке, лишние — опускать.

qazgramma[:v1][:free|pro][:задача][:вариант]

qazgramma                                → исправить ошибки, бесплатно
qazgramma:pro                            → то же, платный тариф
qazgramma:v1:pro:text.summarize          → сократить (вариант medium)
qazgramma:v1:pro:text.summarize:bullets  → сократить списком
qazgramma:v1:pro:style.rewrite:news      → переписать в стиле новости
qazgramma:v1:pro:gov.review:glossary     → проверить по глоссарию

Что платформа умеет и чего не умеет

Список закрытый: если чего-то нет в левом столбце — этого нет. Правый столбец существует, чтобы не тратить ваше время на проверку.

Ограничения

Числа настоящие: столько выдаётся и столько проверяется на сервере.

Эндпоинты

Ошибки

{ "error": { "message": "…", "type": "…", "code": "…" } }

Qazgramma: API задач

Инструменты казахского языка: правка ошибок, стиль, суммаризация, госдокументы и обратная генерация ошибок для обучающих наборов. Задача называется в имени модели — отдельное поле в теле не проходит ни через типизированный TypeScript SDK, ни через ноду OpenAI в n8n.

qazgramma:v1:pro:style.rewrite:news   канонический вид

qazgramma                       → qazgramma:v1:free:gec.correct
qazgramma:pro                   → qazgramma:v1:pro:gec.correct
qazgramma:v1:pro:style.rewrite  → …:style.rewrite:neutral

Сегменты опознаются по значению, а не по позиции. Дефолт подставляется за пропущенный сегмент и никогда за нераспознанный: gec.corect с опечаткой вернёт E_TASK_UNKNOWN, а не выполнит молча другую задачу.

{
  "schema_version": "1.0",
  "status": "ok",
  "task":   "gec.correct",
  "model":  "qazgramma:v1:free:gec.correct",
  "result": { "text": "Мен кітапты оқыдым.", "changed": true },
  "corrections": [ {
    "edit_type": "replace",
    "spans": [ {"start": 4, "end": 11} ],   // руны, [start, end)
    "original": "кітапды", "corrected": "кітапты",
    "layer": "GRAM",
    "codes": [ "GEC.SEPTIK", "GEC.UNDESTIK" ],
    "confidence": 0.6, "classified_by": "rules"
  } ]
}

Рецепты

from openai import OpenAI
import json

client = OpenAI(base_url="https://router.tilqazyna.kz/v1", api_key="sk-tq-…")

r = client.chat.completions.create(
    model="qazgramma:v1:free:gec.correct",
    messages=[{"role": "user", "content": "Мен кітапды оқыдым."}],
)
data = json.loads(r.choices[0].message.content)
print(data["result"]["text"])          # Мен кітапты оқыдым.

curl https://router.tilqazyna.kz/v1/chat/completions \
  -H "Authorization: Bearer sk-tq-…" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qazgramma:v1:pro:style.rewrite:news",
    "messages": [{"role":"user","content":"Кеше мектепте жиналыс болды."}]
  }'

В n8n укажите модель строкой в ноде OpenAI Chat Model — ничего сверх стандартных полей не требуется. Ради этого задача и живёт в имени модели.