Source: https://ailoot.ai/docs/kk/api/responses/
Canonical: https://ailoot.ai/docs/kk/api/responses/
Language: kk

[API](https://ailoot.ai/docs/kk/) 

# Responses

[Markdown](https://ailoot.ai/docs/kk/api/responses/index.md)

OpenAI-дың жаңа форматы: бір кіріс, типтелген шығыс, құралдар және пайымдау. Оны Codex CLI қолданады.

POST`https://api.ailoot.ai/v1/responses`

Responses

```bash
curl https://api.ailoot.ai/v1/responses \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-sol",
    "instructions": "Қысқа жауап бер.",
    "input": "TCP-дің UDP-ден айырмашылығы қандай?"
  }' 
```

```python
from openai import OpenAI
import os

client = OpenAI(max_retries=0, base_url="https://api.ailoot.ai/v1", api_key=os.environ["AILOOT_API_KEY"])
resp = client.responses.create(
    model="gpt-6.1-sol",
    instructions="Қысқа жауап бер.",
    input="TCP-дің UDP-ден айырмашылығы қандай?",
)
print(resp.output_text)
```

```js
import OpenAI from "openai";

const client = new OpenAI({ maxRetries: 0, baseURL: "https://api.ailoot.ai/v1", apiKey: process.env.AILOOT_API_KEY });
const resp = await client.responses.create({
  model: "gpt-6.1-sol",
  instructions: "Қысқа жауап бер.",
  input: "TCP-дің UDP-ден айырмашылығы қандай?",
});
console.log(resp.output_text);
```

200 OK

```json
{
  "id": "resp_67f1…",
  "object": "response",
  "status": "completed",
  "model": "gpt-6.1-sol",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        { "type": "output_text", "text": "TCP жеткізуді және реттілікті қамтамасыз етеді, UDP қамтамасыз етпейді, бірақ жылдамырақ…" }
      ]
    }
  ],
  "usage": { "input_tokens": 24, "output_tokens": 61, "total_tokens": 85 }
}
```

## Авторизация

| Параметр | Түрі | Міндетті | Сипаттама |
| --- | --- | --- | --- |
| `Authorization` | header | міндетті | Кілт мына пішімде `Bearer sk-…`. Сондай-ақ мына тақырыптар жарайды: `x-api-key` немесе `x-goog-api-key`. |

## Сұрау денесі

| Параметр | Түрі | Міндетті | Сипаттама |
| --- | --- | --- | --- |
| `model` | string | міндетті | Responses форматындағы модель ID-і. Каталогта мұндай 53 идентификатор бар: GPT, Claude, DeepSeek, Qwen, Kimi, GLM, MiniMax, Grok. Gemini модельдері бұл форматта қолжетімсіз. |
| `input` | string \| array | міндетті | Сұрау мәтіні немесе хабарламалар мен бөліктер массиві (мәтін, суреттер). |
| `instructions` | string | міндетті емес | Жүйелік нұсқау. |
| `stream` | boolean | міндетті емес | SSE оқиғалар ағыны; соңғы оқиға — `response.completed`. Ақылы мәтін құны есептелгеннен кейін бір блокпен келеді. |
| `max_output_tokens` | integer | міндетті емес | Пайымдауды қоса алғандағы жауап токендерінің ең көп саны. Көрсетілмесе, Ailoot 4096 қояды (немесе модельдің жауап лимиті одан аз болса, сол мәнді). Ұзын жауаптар үшін лимитті нақты көрсетіңіз. Мына өрісі бар сұраулар: `previous_response_id` және мына кіріктірілген құралдары бар сұраулар: `web_search` немесе `code_interpreter` жаңа мәтіндік сұраулар үшін сақталған контекст пен құралдар жұмысының бөлек бағалауларын ескереді; олар автоматты түрде бүкіл кіріс терезесінің құнына ауыспайды. Бұрын қабылданған резервтердің бастапқы шарттары сақталады. Шығыстағы суреттер, бейне және дыбыс үшін нәтиженің толық құны резервтеледі. Есептелген резерв бос балансқа немесе кілт лимитіне сыймаса, қолдау көрсетілетін модель мен әдісте Ailoot `max_tokens` (`max_output_tokens` Responses форматында) мәнін төлеуге болатын көлемге дейін, бірақ 256 токеннен немесе осы әдістің одан жоғары ең аз мөлшерінен төмендетпей азайта алады және бұл туралы мына тақырыпта хабарлайды `X-Ailoot-Max-Tokens-Capped`. Азайту мүмкіндігі нақты мәтіндік модель мен әдіс үшін тексеріледі. Ол Gemini-дің төл форматындағы және Anthropic Messages форматындағы қолдау көрсетілетін Gemini мәтіндік маршруттарына қолданылады; `deepseek-ai/deepseek-v4.1-flash`, `meta/llama-3.2-11b-vision-instruct`, `meta/muse-glimmer-30b`, `nvidia/ising-calibration-1.5-31b`, `nvidia/nemotron-3-nano-omni-30b-a3b-reasoning`, `nvidia/nemotron-3-super-120b-a12b`, `nvidia/nemotron-3-ultra-550b-a55b`, `nvidia/nemotron-3.5-content-safety`, `nvidia/nemotron-3.5-lightning-30b-a3b`, `nvidia/riva-translate-4b-instruct-v1.1`, `nvidia/riva-translate-4b-instruct-v2`, `poolside/laguna-xs-2.1`, `z-ai/glm-5.3-flash` — Chat Completions және Messages форматтарында (модель оларды қолдайтын жерде). **Шығыс** жаңа мәтіндік сұраудың резерві үшін әдеттегі жауап ұзындығы мен қабылданған шарттар бойынша бағаланады. Сұралған лимит мына параметр арқылы беріледі `max_tokens` (`max_output_tokens` Responses форматында). Сұралған лимит резерв есептелген токен санына автоматты түрде тең болмайды және сенімді шектеуі жоқ модельде жауаптың нақты ұзындығына кепілдік бермейді. Бастапқы 4096 мәні тек тиісті маршруттарға қолданылады; нақты қағида модель мен әдіске байланысты. |
| `reasoning` | object | міндетті емес | `{"effort": "low" \| "medium" \| "high"}` пайымдайтын модельдер үшін. |
| `tools` | array | міндетті емес | Модель шақыра алатын функциялар. |
| `text` | object | міндетті емес | Жауап форматы, мысалы `{"format": {"type": "json_schema", ...}}`. |
| `temperature` | number | міндетті емес | Жауаптың кездейсоқтық деңгейі, модель қолдаса. |

## Жауап

| Параметр | Түрі | Міндетті | Сипаттама |
| --- | --- | --- | --- |
| `output` | array |  | Жауап элементтері: хабарламалар (`message`), пайымдау, функция шақырулары. SDK ішінде мына мәнді алу ыңғайлы: `output_text`. |
| `status` | string |  | `completed`, `incomplete` (лимитке жетті) немесе `failed`. |
| `usage` | object |  | `input_tokens`, `output_tokens`, `total_tokens`. |

Сұрақтарыңыз қалды ма? Request ID мен сипаттаманы жіберіңіз — мәселені анықтауға көмектесеміз.[Қолдау қызметіне жазу](mailto:support@ailoot.ai)

## Ailoot · Компания және оның жобалар портфелі





Ailoot жинақталған жұмыс тәжірибесіне, кең клиенттік базаға, тұрақты қызметке және KPI көрсеткіштерін үздіксіз бақылауға сүйенеді.





Компания және оның жобалар портфелі: миллиондаған клиент; ай сайынғы сату көлемі миллиардтармен есептеледі.





Ailoot осы тәжірибені клиенттердің өнімдерінде, агенттерінде, қолданбаларында және автоматтандыруларында жасанды интеллект мүмкіндіктеріне API арқылы қол жеткізуді қамтамасыз етуге пайдаланады.
