Responses
MarkdownNaujas OpenAI formatas: viena įvestis, tipizuota išvestis, įrankiai ir samprotavimas. Jį naudoja Codex CLI.
Visas vadovas
https://api.ailoot.ai/v1/responsescurl https://api.ailoot.ai/v1/responses \
-H "Authorization: Bearer $AILOOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6.1-sol",
"instructions": "Atsakyk trumpai.",
"input": "Kuo TCP skiriasi nuo 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="Atsakyk trumpai.",
input="Kuo TCP skiriasi nuo 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: "Atsakyk trumpai.",
input: "Kuo TCP skiriasi nuo 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 garantuoja pristatymą ir eiliškumą, o UDP — ne, tačiau veikia greičiau…" }
]
}
],
"usage": { "input_tokens": 24, "output_tokens": 61, "total_tokens": 85 }
}Autorizacija
- Authorizationheaderprivalomas
Raktas formatu
Bearer sk-…. Taip pat tinka antraštėsx-api-keyarbax-goog-api-key.
Užklausos turinys
- modelstringprivalomas
Responses formato modelio ID. Kataloge jų yra 53: GPT, Claude, DeepSeek, Qwen, Kimi, GLM, MiniMax, Grok. Gemini modeliai šiuo formatu neprieinami.
- inputstring | arrayprivalomas
Užklausos tekstas arba pranešimų ir dalių masyvas (tekstas, vaizdai).
- instructionsstringneprivalomas
Sistemos instrukcija.
- streambooleanneprivalomas
SSE įvykių srautas; paskutinis įvykis —
response.completed. Mokamas tekstas pateikiamas vienu bloku apskaičiavus kainą. - max_output_tokensintegerneprivalomas
Didžiausias atsakymo žetonų skaičius, įskaitant samprotavimą. Jei nenurodytas, Ailoot nustato 4096 (arba mažiau, jei modelio atsakymo limitas mažesnis). Ilgiems atsakymams limitą nustatykite aiškiai. Užklausos su
previous_response_idir integruotais įrankiaisweb_searcharbacode_interpreternaujoms tekstinėms užklausoms atsižvelgia į atskirus išsaugoto konteksto ir įrankių darbo įverčius; jos automatiškai nepereina prie viso įvesties lango kainos. Anksčiau priimtiems rezervams lieka pradinės sąlygos. Vaizdų, vaizdo įrašų ir garso išvesčiai rezervuojama visa rezultato kaina. Jei apskaičiuotas rezervas netelpa į prieinamą balansą ar rakto limitą, Ailoot gali palaikomam modeliui ir metodui sumažintimax_tokens(max_output_tokensResponses atveju) iki apmokamos apimties, bet ne žemiau 256 žetonų ar didesnio tam metodui nustatyto minimumo, ir praneša apie tai antraštėjeX-Ailoot-Max-Tokens-Capped. Galimybė sumažinti limitą tikrinama konkrečiam tekstiniam modeliui ir metodui. Ji taikoma palaikomiems Gemini tekstiniams maršrutams savuoju Gemini formatu ir Anthropic Messages formatu;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 ir Messages formatais (ten, kur modelis juos palaiko). Išvestis naujos tekstinės užklausos rezervui įvertinama pagal tipinį atsakymo ilgį ir priimtas sąlygas. Prašomas limitas nustatomas naudojantmax_tokens(max_output_tokensResponses atveju). Prašomas limitas savaime nesutampa su žetonų skaičiumi, pagal kurį apskaičiuotas rezervas, ir negarantuoja faktinio atsakymo ilgio modeliui be patikimo apribojimo. Pradinė reikšmė 4096 taikoma tik atitinkamiems maršrutams; konkreti taisyklė priklauso nuo modelio ir metodo. - reasoningobjectneprivalomas
{"effort": "low" | "medium" | "high"}samprotavimo modeliams. - toolsarrayneprivalomas
Funkcijos, kurias modelis gali iškviesti.
- textobjectneprivalomas
Atsakymo formatas, pavyzdžiui,
{"format": {"type": "json_schema", ...}}. - temperaturenumberneprivalomas
Atsakymo atsitiktinumas, jei modelis jį palaiko.
Atsakymas
- outputarray
Atsakymo elementai: pranešimai (
message), samprotavimas, funkcijų iškvietimai. SDK patogu naudotioutput_text. - statusstring
completed,incomplete(pasiektas limitas) arbafailed. - usageobject
input_tokens,output_tokens,total_tokens.