Source: https://ailoot.ai/docs/kk/api/systemone/ Canonical: https://ailoot.ai/docs/kk/api/systemone/ Language: kk [API](https://ailoot.ai/docs/kk/) # Jev — шешім моделі [Markdown](https://ailoot.ai/docs/kk/api/systemone/index.md) TypeSafe ұсынған Jev шешім моделі мәтін не JSON туралы типтелген сұрақтарға жауап береді: нұсқа таңдау, шкала бойынша бағалау немесе ықтималдығы бар «иә/жоқ». Бұл чат та, мәтін генерациясы да емес. POST`https://api.ailoot.ai/v1/systemone` Jev — шешім моделі ```bash curl https://api.ailoot.ai/v1/systemone \ -H "Authorization: Bearer $AILOOT_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "jev-latest", "state": "Көмектесіңіз! Маған төленетін ақша 3 күннен бері аударылмай жатыр.", "questions": { "is_urgent": { "type": "noul", "instructions": "Бұл шұғылдықты білдіре ме?" } } }' ``` ```python import json, os, urllib.request body = { "model": "jev-latest", "state": "Көмектесіңіз! Маған төленетін ақша 3 күннен бері аударылмай жатыр.", "questions": { "is_urgent": {"type": "noul", "instructions": "Бұл шұғылдықты білдіре ме?"}, }, } req = urllib.request.Request( "https://api.ailoot.ai/v1/systemone", data=json.dumps(body).encode(), headers={"Authorization": "Bearer " + os.environ["AILOOT_API_KEY"], "Content-Type": "application/json"}, ) with urllib.request.urlopen(req, timeout=60) as resp: result = json.load(resp) print(result["answers"]["is_urgent"]["noul"]) # 0.95 ``` ```js const resp = await fetch("https://api.ailoot.ai/v1/systemone", { method: "POST", headers: { Authorization: `Bearer ${process.env.AILOOT_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ model: "jev-latest", state: "Көмектесіңіз! Маған төленетін ақша 3 күннен бері аударылмай жатыр.", questions: { is_urgent: { type: "noul", instructions: "Бұл шұғылдықты білдіре ме?" }, }, }), }); const result = await resp.json(); if (!resp.ok) throw new Error(`${resp.status} ${JSON.stringify(result)}`); console.log(result.answers.is_urgent.noul); // 0.95 ``` 200 OK ```json { "model": "jev-1.13.0", "answers": { "is_urgent": { "type": "noul", "noul": 0.95 } }, "usage": { "input_tokens": 296, "output_tokens": 20 } } ``` Jev — TypeSafe ұсынған System One класындағы шешім моделі. Ол мәтін жазбайды және диалог жүргізбейді: сіз мынаны бересіз: **күй** (`state`) — мәтін немесе JSON — және мына жиынды: **сұрақтар**, ал жауапта ықтималдықтары бар типтелген мәндер аласыз. Код олар бойынша еркін мәтінді талдамай-ақ бірден тармақталады, сұрыптайды және бағыттайды. Бір сұраудағы барлық сұрақ бірдей мына дерекке қатысты қатар әрі бір-бірінен тәуелсіз бағаланады: `state`. TypeSafe деректері бойынша, сұрақтарды қосу жауап уақытын өзгертпейді дерлік және сұрақтар бір-біріне кедергі келтірмейді. | Не | Қысқаша | | --- | --- | | Модель | `jev-latest` — Jev-тің соңғы тұрақты нұсқасының бүркеншік атауы; [каталогтағы карточка](https://ailoot.ai/models/kk/#m=jev-latest) | | Әдіс | `POST /v1/systemone`. Бұл чат емес: OpenAI, Anthropic және Gemini форматтары Jev үшін жарамайды. Жауап толық, бір JSON түрінде келеді | | Не қабылдайды | Тек мәтін: жол, JSON нысаны немесе мәтіндер массиві. Суреттерді, аудионы және бейнені алдымен мәтінге айналдырыңыз | | Контекст | Бір сұрауға 64K токен — state пен барлық сұрақ бірге; state пен ең ұзын сұрақ бірге — 32K-ға дейін | | Тіл | TypeSafe деректері бойынша, модель ағылшын тілінде ең дәл жұмыс істейді; басқа тілдерді де қабылдайды, бірақ дәлдігі төменірек — өз деректеріңізде тексеріңіз | | Баға | Кіріс үшін 1 млн токенге $0.084, шығыс тегін | ## [](https://ailoot.ai/docs/kk/api/systemone/#request)Сұрау ### Авторизация | Параметр | Түрі | Міндетті | Сипаттама | | --- | --- | --- | --- | | `Authorization` | header | міндетті | Ailoot кілті мына пішімде: `Bearer sk-…`. | ### Сұрау денесі | Параметр | Түрі | Міндетті | Сипаттама | | --- | --- | --- | --- | | `model` | string | міндетті | `jev-latest`. | | `state` | string \| object \| array | міндетті | Не бағаланады: мәтіні бар жол немесе JSON — клиент өтініші, дерекқор жазбасы, хат алмасу, қолданбаңыздың ағымдағы күйі. Өріс атаулары түсінікті нысан әдетте бір жолдан ыңғайлы. | | `questions` | object | міндетті | Сұрақтар. Кілттерді өзіңіз таңдайсыз, жауаптар сол кілттермен келеді; кілт жауапқа әсер етпейді — сұрақтың өзі мына жерде беріледі: `instructions`. | | `questions.*.type` | string | міндетті | `noul`, `choice` немесе `score` — төменде қараңыз. | | `questions.*.instructions` | string \| object \| array | міндетті | Сұрақтың өзі. Деректері бар ұзын сұрақты нысан түрінде беруге болады: сұрақ бір өрісте, деректер басқа өрістерде; өрістерге атауын кері тырнақшаға алып сілтеңіз. | | `questions.*.criteria` | object \| array | | Жауап нұсқалары әр түрге бөлек: noul үшін «иә» және «жоқ» сипаттамалары (міндетті емес), choice үшін нұсқалар сөздігі, score үшін деңгейлердің реттелген тізімі. | ## [](https://ailoot.ai/docs/kk/api/systemone/#question-types)Сұрақ түрлері | Түрі | Не сұрайды | Не қайтарады | | --- | --- | --- | | `noul` | Тұжырым дұрыс па: иә немесе жоқ | `noul` — «иә» ықтималдығы, 0-ден 1-ге дейін | | `choice` | Берілген нұсқалардың қайсысы сәйкес келеді | `choice`, `probabilities`, `confidence` | | `score` | Деңгейлер шкалаңызда state қай жерде орналасқан | `score`, `legend`, `probabilities`, `confidence` | Бір сұрауда әртүрлі түрді бірге қолдануға болады. ### noul — иә немесе жоқ Өріс `criteria` міндетті емес: мұнда «иә» (`true`) және «жоқ» (`false`) нені білдіретінін сипаттауға болады. Жауап `noul` — 0-ден (жоқ) 1-ге (иә) дейінгі сан. ```json "is_urgent": { "type": "noul", "instructions": "Бұл шұғылдықты білдіре ме?", "criteria": { "true": "Уақыттың тығыз екені анық көрсетілген", "false": "Шұғылдық көрсетілмеген" } } ``` ```json "is_urgent": { "type": "noul", "noul": 0.95 } ``` ### choice — нұсқа таңдау `criteria` — «нұсқа → сипаттама» сөздігі; сипаттама қажет болмаса, мынаны көрсетіңіз: `null`. 255 нұсқаға дейін. Жауапта `choice` — ең ықтимал нұсқа, `probabilities` — әр нұсқаның ықтималдығы (қосындысы 1), `confidence` — сенімділік, 0-ден 1-ге дейін. ```json "department": { "type": "choice", "instructions": "Мұны қай топ қарауы керек?", "criteria": { "billing": "Төлемдер, шот ұсыну, ақшаны қайтару", "technical": "Қателер, қызметтің тоқтауы, интеграциялар", "sales": "Бағалар, жоғары тарифке ауысу, жаңа клиенттер" } } ``` ```json "department": { "type": "choice", "choice": "billing", "probabilities": { "billing": 0.88, "technical": 0.12, "sales": 0.0 }, "confidence": 0.81 } ``` ### score — шкала бойынша бағалау `criteria` — ең төменнен ең жоғарыға қарай деңгейлер, 10-нан аспайды (TypeSafe кемінде екі деңгейді ұсынады). Жауапта `score` — деңгейлер ықтималдығымен өлшенген мән (деңгейлердің арасында болуы мүмкін), `legend` — деңгей нөмірі мен оның сипаттамасы, `probabilities` және `confidence`. TypeSafe деректері бойынша, `score` шекпен салыстыруға жарайды, бірақ деңгейлер арасындағы дәл сан ретінде жарамайды. ```json "frustration": { "type": "score", "instructions": "Клиент қаншалықты наразы?", "criteria": ["Сабырлы", "Наразы", "Аса ашулы"] } ``` ```json "frustration": { "type": "score", "score": 1.05, "legend": { "0": "Сабырлы", "1": "Наразы", "2": "Аса ашулы" }, "probabilities": { "0": 0.0, "1": 0.95, "2": 0.05 }, "confidence": 0.92 } ``` ## [](https://ailoot.ai/docs/kk/api/systemone/#response)Жауап | Параметр | Түрі | Міндетті | Сипаттама | | --- | --- | --- | --- | | `model` | string | | Модельдің қай нұсқасы жауап бергенін көрсетеді. jev-latest бүркеншік атауы уақыт өте жаңа нұсқаларға көшеді: егер мына шектерді: `confidence` нақты нұсқаға бейімдеген болсаңыз, осы өрісті қадағалаңыз. | | `answers` | object | | Әр сұраққа бір жауап, дәл сол кілттермен. Әр жауапта мына өріс бар: `type`, ал choice пен score ішінде қосымша `confidence`. | | `usage` | object | | `input_tokens` және `output_tokens`. Тек кіріс токендеріне ақы алынады. | `confidence` шек ретінде қолдануға ыңғайлы: жауап сенімді болса — автоматты түрде әрекет етіңіз, сенімсіз болса — адамға немесе үлкен модельге тексеруге жіберіңіз. Жауап нені таңдау керегін, ал `confidence` — әрекет ету керек пе екенін көрсетеді. ## [](https://ailoot.ai/docs/kk/api/systemone/#many-questions)Бір сұрауда бірнеше сұрақ Бір state туралы барлық сұрақты бір сұрауда қойыңыз: олар қатар бағаланады, ал state бір рет беріледі. TypeSafe деректері бойынша, олардың 13 сұрақтық мысалында бір ортақ сұрау дәл сол жауаптармен 13 сұрауды кезекпен бөлек жібергеннен 12,2 есе арзан және 10 есе жылдам болған. Күрделі пайымды қарапайым сұрақтарға бөліп, жауаптарды кодта біріктірген жөн: мысалы, «өтінімді бағала» деудің орнына нарықты, іске асырылу мүмкіндігін және бәсекелестерден айырмашылығын бөлек бағалау. Сонда салмақтар сұрақ мәтінінде емес, кодта өзгереді. ```json { "model": "jev-latest", "state": "Көмектесіңіз! Маған төленетін ақша 3 күннен бері аударылмай жатыр.", "questions": { "department": { "type": "choice", "instructions": "Мұны қай топ қарауы керек?", "criteria": { "billing": "Төлемдер, шот ұсыну, ақшаны қайтару", "technical": "Қателер, қызметтің тоқтауы, интеграциялар", "sales": "Бағалар, жоғары тарифке ауысу, жаңа клиенттер" } }, "frustration": { "type": "score", "instructions": "Клиент қаншалықты наразы?", "criteria": ["Сабырлы", "Наразы", "Аса ашулы"] }, "is_urgent": { "type": "noul", "instructions": "Бұл шұғылдықты білдіре ме?" } } } ``` ## [](https://ailoot.ai/docs/kk/api/systemone/#use-cases)Қай кезде жарайды - **Бағыттау.** Өтінішті тиісті бөлімге, ал сұрауды тиісті өңдеушіге жіберу: қарапайым кодқа, үлкен модельге немесе адамға. - **Сұрыптау және басымдық.** Шұғылдық, реңк, тәуекел — шкала бойынша, шектері кодта беріледі. - **Модерация және тексерулер.** Хабарлама ережені бұза ма, дереккөз дәйексөзді растай ма, құжатта сұрақтың жауабы бар ма — мәтін әрі қарай жіберілмей тұрып тексеру. - **Скоринг және ранжирлеу.** Құжаттарды, үміткерлерді немесе табылған үзінділерді өз бағалау өлшемдеріңізбен бағалап, әрі қарай не жіберілетінін кодта шешу. - **Сенімсіз «JSON қайтар» нұсқауының орнына.** Талдауды қажет ететін мәтінді емес, құрылымы бойынша типтелген мәндерді қайтаратын шақыру. ## [](https://ailoot.ai/docs/kk/api/systemone/#not-for)Қай кезде жарамайды - **Чат, пайдаланушыға жауап беру, мәтін немесе код генерациялау.** Jev мәтін жазбайды — ол үшін мына модельдер бар: [мәтіндік модельдер](https://ailoot.ai/models/kk/?kind=text). - **Claude Code, Cursor және басқа агенттер үшін модель.** Агент моделінің орнына jev-latest қою мүмкін емес: агентке мәтін жазатын және құрал шақыратын модель қажет. Jev-ті агент сіз үшін жазған кодтан шақыруға болады. - **Арифметика, санау, күндерді салыстыру.** TypeSafe деректері бойынша, мұны кодта орындау сенімдірек, ал модельден тек мағыналық бөлігін сұраған жөн — мысалы, choice арқылы күннің бөліктерін шығару. - **Суреттер, аудио және бейне.** Модель тек мәтінді қабылдайды — мұндай деректерді алдын ала мәтінге айналдырыңыз. Модель әр сұрақ бір нақты, тар пайым болғанда жақсы жұмыс істейді. Шартты тура жазыңыз: TypeSafe деректері бойынша, модель сұрақты сөзбе-сөз түсінеді, ал артық деректері бар үлкен state дәлдікті төмендетеді — оны кодта сүзіңіз. ## [](https://ailoot.ai/docs/kk/api/systemone/#price)Баға Тек кіріс токендеріне ақы алынады — жауаптағы `usage.input_tokens` өрісі бойынша: **1 млн үшін $0.084**. Шығыс токендері тегін. Осы беттегі мысал сұрауы (296 кіріс токені) $0.0001-ден аз тұрады. Сұрау алдында Ailoot баланста соманы резервтейді және жауаптан кейін нақты шығын бойынша бір рет есептен шығарады — [бұл қалай жұмыс істейді](https://ailoot.ai/docs/kk/billing/reserve/). ## [](https://ailoot.ai/docs/kk/api/systemone/#limits)Лимиттер | Не | Лимит | | --- | --- | | Бүкіл сұрау: state және барлық сұрақ | 64K токен | | state және ең ұзын сұрақ бірге | 32K токен | | Бір choice ішіндегі нұсқалар | 255-ке дейін | | Бір score ішіндегі деңгейлер | 2-ден 10-ға дейін | | Кіріс | тек мәтін: жол, JSON нысаны немесе мәтіндер массиві | Модель лимиттері TypeSafe деректері бойынша берілген. Кілтіңіз бен балансыңыздың шектеулері Ailoot-тың кез келген моделіндегідей қолданылады: [Қателер және лимиттер](https://ailoot.ai/docs/kk/errors/). ## [](https://ailoot.ai/docs/kk/api/systemone/#errors)Қателер Қателер Ailoot API-інің жалпы форматында келеді: код, түсінікті мәтін және Request ID. Бұл әдісте ең жиі кездесетіндері: | Код | Қай кезде | Не істеу керек | | --- | --- | --- | | **400** `invalid_request` | Дене тексеруден өтпеді: state, model немесе questions жоқ, type белгісіз, choice ішінде 255-тен көп нұсқа немесе score ішінде 10-нан көп деңгей бар | Сұрауды қате мәтініне қарай түзетіңіз: түзетпесеңіз, ол қайтадан өтпейді | | **400** `context_length_exceeded` | state пен сұрақтар бірге модель лимитінен ұзын | state дерегін кодта сүзіп, сұрақтарға керегін ғана қалдырыңыз | | **401** `invalid_api_key` | Кілт жоқ немесе қате | Кілтті Authorization тақырыбында жіберіңіз | | **402** `insufficient_balance` | Резервке бос баланс жетпейді | Балансты толықтырыңыз | | **404** `model_not_found`, `unsupported_endpoint` | ID қате немесе модель басқа әдіспен шақырылған, мысалы /v1/chat/completions арқылы | jev-latest моделін тек POST /v1/systemone арқылы шақырыңыз | | **429** `rate_limit_exceeded` | Сұрау тым көп | Retry-After тақырыбында көрсетілген секунд бойы күтіп, қайталаңыз | | **503** `model_overloaded`, `model_unavailable` | Модель уақытша шамадан тыс жүктелген немесе қолжетімсіз | X-Should-Retry: true болса — Retry-After секундтан кейін қайталаңыз; false болса — алдымен тарихтан Request ID-ді тексеріңіз | | **504** `model_timeout` | Модель уақытында жауап бермеді | Тарихтан Request ID-ді тексермейінше сұрауды қайта жібермеңіз | Кодтардың толық тізімі мына бетте: [Қателер және лимиттер](https://ailoot.ai/docs/kk/errors/). Сұрақтарыңыз қалды ма? Request ID мен сипаттаманы жіберіңіз — мәселені анықтауға көмектесеміз.[Қолдау қызметіне жазу](mailto:support@ailoot.ai) ## Ailoot · Компания және оның жобалар портфелі Ailoot жинақталған жұмыс тәжірибесіне, кең клиенттік базаға, тұрақты қызметке және KPI көрсеткіштерін үздіксіз бақылауға сүйенеді. Компания және оның жобалар портфелі: миллиондаған клиент; ай сайынғы сату көлемі миллиардтармен есептеледі. Ailoot осы тәжірибені клиенттердің өнімдерінде, агенттерінде, қолданбаларында және автоматтандыруларында жасанды интеллект мүмкіндіктеріне API арқылы қол жеткізуді қамтамасыз етуге пайдаланады.