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": "Odgovarjaj na kratko.",
    "input": "Kakšna je razlika med TCP in 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="Odgovarjaj na kratko.",
    input="Kakšna je razlika med TCP in 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: "Odgovarjaj na kratko.",
  input: "Kakšna je razlika med TCP in 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 zagotavlja dostavo in pravilen vrstni red, UDP pa ne, vendar je hitrejši…" }
      ]
    }
  ],
  "usage": { "input_tokens": 24, "output_tokens": 61, "total_tokens": 85 }
}

Avtentikacija

• Authorizationheaderobvezno

  Ključ v obliki Bearer sk-…. Uporabite lahko tudi glavi x-api-key ali x-goog-api-key.

Telo zahteve

• modelstringobvezno

  ID modela s formatom Responses. V katalogu jih je 53: GPT, Claude, DeepSeek, Qwen, Kimi, GLM, MiniMax in Grok. Modeli Gemini v tem formatu niso na voljo.

• inputstring | arrayobvezno

  Besedilo zahteve ali polje sporočil in delov (besedilo, slike).

• instructionsstringneobvezno

  Sistemsko navodilo.

• streambooleanneobvezno

  Tok dogodkov SSE; zadnji dogodek je response.completed. Plačljivo besedilo prispe v enem bloku po izračunu stroškov.

• max_output_tokensintegerneobvezno

  Največje število žetonov odgovora, vključno s sklepanjem. Če ni navedeno, Ailoot uporabi 4096 (ali manj, če ima model nižjo omejitev odgovora). Za dolge odgovore omejitev nastavite izrecno. Zahteve s parametrom previous_response_id in z vgrajenimi orodji web_search ali code_interpreter pri novih besedilnih zahtevah upoštevajo ločene ocene shranjenega konteksta in delovanja orodij; ne preidejo samodejno na strošek celotnega vhodnega okna. Predhodno sprejete rezervacije ohranijo prvotne pogoje. Pri slikah, videu in zvoku na izhodu se rezervira celotni strošek rezultata. Če izračunana rezervacija presega razpoložljivo stanje ali omejitev ključa, lahko Ailoot pri podprtem modelu in metodi zniža max_tokens (max_output_tokens pri Responses) do obsega, ki ga razpoložljiva sredstva pokrijejo, vendar ne pod 256 žetonov ali višji minimum te metode, in to sporoči v glavi X-Ailoot-Max-Tokens-Capped. Možnost znižanja se preveri za točno določeni besedilni model in metodo. Velja za podprte besedilne poti Gemini v izvornem formatu Gemini in formatu 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 – pri formatih Chat Completions in Messages (kjer ju model podpira). Izhod se za rezervacijo nove besedilne zahteve oceni glede na tipično dolžino odgovora in sprejete pogoje. Zahtevana omejitev se nastavi s parametrom max_tokens (max_output_tokens pri Responses). Zahtevana omejitev ni samodejno enaka številu žetonov, na podlagi katerega se izračuna rezervacija, in pri modelu brez zanesljive omejitve ne zagotavlja dejanske dolžine odgovora. Začetna vrednost 4096 velja le za ustrezne poti; natančno pravilo je odvisno od modela in metode.

• reasoningobjectneobvezno

  {"effort": "low" | "medium" | "high"} za modele za sklepanje.

• toolsarrayneobvezno

  Funkcije, ki jih model lahko pokliče.

• textobjectneobvezno

  Format odgovora, na primer {"format": {"type": "json_schema", ...}}.

• temperaturenumberneobvezno

  Naključnost odgovora, če jo model podpira.

Odgovor

• outputarray

  Elementi odgovora: sporočila (message), sklepanje, klici funkcij. V SDK je priročno uporabiti output_text.

• statusstring

  completed, incomplete (dosežena omejitev) ali failed.

• usageobject

  input_tokens, output_tokens, total_tokens.