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

Qazgramma: API задач

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

qazgramma[:версия][:тариф][:задача][:вариант]
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"
  } ]
}
Честно о классификаторе

Категорию правки ставят правила по морфемам. Чего они не распознали — GEC.UNKNOWN с confidence: 0. Поле codes — массив: одна морфема бывает сразу двух категорий, как в примере выше, где выбор аффикса -ты это и падеж, и закон благозвучия.