Responses

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-ден айырмашылығы қандай?"
  }' 

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)

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);

{
  "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 }
}

Авторизация

• Authorizationheaderміндетті

  Кілт мына пішімде Bearer sk-…. Сондай-ақ мына тақырыптар жарайды: x-api-key немесе x-goog-api-key.

Сұрау денесі

• modelstringміндетті

  Responses форматындағы модель ID-і. Каталогта мұндай 53 идентификатор бар: GPT, Claude, DeepSeek, Qwen, Kimi, GLM, MiniMax, Grok. Gemini модельдері бұл форматта қолжетімсіз.

• inputstring | arrayміндетті

  Сұрау мәтіні немесе хабарламалар мен бөліктер массиві (мәтін, суреттер).

• instructionsstringміндетті емес

  Жүйелік нұсқау.

• streambooleanміндетті емес

  SSE оқиғалар ағыны; соңғы оқиға — response.completed. Ақылы мәтін құны есептелгеннен кейін бір блокпен келеді.

• max_output_tokensintegerміндетті емес

  Пайымдауды қоса алғандағы жауап токендерінің ең көп саны. Көрсетілмесе, 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 мәні тек тиісті маршруттарға қолданылады; нақты қағида модель мен әдіске байланысты.

• reasoningobjectміндетті емес

  {"effort": "low" | "medium" | "high"} пайымдайтын модельдер үшін.

• toolsarrayміндетті емес

  Модель шақыра алатын функциялар.

• textobjectміндетті емес

  Жауап форматы, мысалы {"format": {"type": "json_schema", ...}}.

• temperaturenumberміндетті емес

  Жауаптың кездейсоқтық деңгейі, модель қолдаса.

Жауап

• outputarray

  Жауап элементтері: хабарламалар (message), пайымдау, функция шақырулары. SDK ішінде мына мәнді алу ыңғайлы: output_text.

• statusstring

  completed, incomplete (лимитке жетті) немесе failed.

• usageobject

  input_tokens, output_tokens, total_tokens.