docs
API

Responses

Markdown

Naujas OpenAI formatas: viena įvestis, tipizuota išvestis, įrankiai ir samprotavimas. Jį naudoja Codex CLI.

Visas vadovas
POSThttps://api.ailoot.ai/v1/responses
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": "Atsakyk trumpai.",
    "input": "Kuo TCP skiriasi nuo UDP?"
  }' 
200 OK
{
  "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ės x-api-key arba x-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_id ir integruotais įrankiais web_search arba code_interpreter naujoms 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žinti max_tokens (max_output_tokens Responses atveju) iki apmokamos apimties, bet ne žemiau 256 žetonų ar didesnio tam metodui nustatyto minimumo, ir praneša apie tai antraštėje X-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 naudojant max_tokens (max_output_tokens Responses 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 naudoti output_text.

  • statusstring

    completed, incomplete (pasiektas limitas) arba failed.

  • usageobject

    input_tokens, output_tokens, total_tokens.

Liko klausimų? Atsiųskite Request ID ir aprašymą — padėsime išsiaiškinti.Rašyti pagalbos tarnybai