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": "Odpovedaj stručne.",
    "input": "Čím sa TCP líši od 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="Odpovedaj stručne.",
    input="Čím sa TCP líši od 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: "Odpovedaj stručne.",
  input: "Čím sa TCP líši od 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 zaručuje doručenie a poradie, UDP nie, ale je rýchlejšie…" }
      ]
    }
  ],
  "usage": { "input_tokens": 24, "output_tokens": 61, "total_tokens": 85 }
}

Autorizácia

• Authorizationheaderpovinné

  Kľúč vo formáte Bearer sk-…. Možno použiť aj hlavičky x-api-key alebo x-goog-api-key.

Telo požiadavky

• modelstringpovinné

  ID modelu s formátom Responses. V katalógu je ich 53: GPT, Claude, DeepSeek, Qwen, Kimi, GLM, MiniMax, Grok. Modely Gemini v tomto formáte nie sú dostupné.

• inputstring | arraypovinné

  Text požiadavky alebo pole správ a častí (text, obrázky).

• instructionsstringvoliteľné

  Systémová inštrukcia.

• streambooleanvoliteľné

  Stream udalostí SSE; poslednou udalosťou je response.completed. Platený text príde v jednom bloku po výpočte ceny.

• max_output_tokensintegervoliteľné

  Maximálny počet tokenov odpovede vrátane uvažovania. Ak ho neuvediete, Ailoot nastaví 4096 (alebo menej, ak má model nižší limit odpovede). Pri dlhých odpovediach nastavte limit výslovne. Požiadavky s previous_response_id a so vstavanými nástrojmi web_search alebo code_interpreter pri nových textových požiadavkách zohľadňujú samostatné odhady uloženého kontextu a práce nástrojov; neprechádzajú automaticky na cenu celého vstupného okna. Predtým prijaté rezervácie si zachovávajú pôvodné podmienky. Pri obrázkoch, videu a zvuku na výstupe sa rezervuje plná cena výsledku. Ak sa vypočítaná rezervácia nezmestí do dostupného zostatku alebo limitu kľúča, Ailoot môže pri podporovanom modeli a metóde znížiť max_tokens (max_output_tokens v Responses) na objem, ktorý možno zaplatiť, nie však pod 256 tokenov ani pod vyššie minimum danej metódy, a oznámi to v hlavičke X-Ailoot-Max-Tokens-Capped. Možnosť zníženia sa overuje pre konkrétny textový model a metódu. Platí pre podporované textové trasy Gemini v natívnom formáte Gemini a vo formáte Anthropic Messages; 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 – vo formátoch Chat Completions a Messages (ak ich model podporuje). Výstup sa pri rezervácii novej textovej požiadavky odhaduje podľa typickej dĺžky odpovede a prijatých podmienok. Požadovaný limit sa nastavuje cez max_tokens (max_output_tokens v Responses). Požadovaný limit sa automaticky nerovná počtu tokenov, z ktorého sa vypočítala rezervácia, a pri modeli bez spoľahlivého obmedzenia nezaručuje skutočnú dĺžku odpovede. Východisková hodnota 4096 sa používa iba pri príslušných trasách; konkrétne pravidlo závisí od modelu a metódy.

• reasoningobjectvoliteľné

  {"effort": "low" | "medium" | "high"} pre modely s uvažovaním.

• toolsarrayvoliteľné

  Funkcie, ktoré môže model zavolať.

• textobjectvoliteľné

  Formát odpovede, napríklad {"format": {"type": "json_schema", ...}}.

• temperaturenumbervoliteľné

  Miera náhodnosti odpovede, ak ju model podporuje.

Odpoveď

• outputarray

  Prvky odpovede: správy (message), uvažovanie, volania funkcií. V SDK je praktické použiť output_text.

• statusstring

  completed, incomplete (dosiahol sa limit) alebo failed.

• usageobject

  input_tokens, output_tokens, total_tokens.