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": "Válaszoljon röviden.",
    "input": "Mi a különbség a TCP és az UDP között?"
  }' 

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="Válaszoljon röviden.",
    input="Mi a különbség a TCP és az UDP között?",
)
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: "Válaszoljon röviden.",
  input: "Mi a különbség a TCP és az UDP között?",
});
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": "A TCP garantálja a kézbesítést és a sorrendet, az UDP nem, viszont gyorsabb…" }
      ]
    }
  ],
  "usage": { "input_tokens": 24, "output_tokens": 61, "total_tokens": 85 }
}

Hitelesítés

• Authorizationheaderkötelező

  A kulcs formátuma Bearer sk-…. A következő fejlécek is használhatók: x-api-key vagy x-goog-api-key.

A kérés törzse

• modelstringkötelező

  Responses formátumot támogató modell azonosítója. A katalógusban 53 ilyen található: GPT, Claude, DeepSeek, Qwen, Kimi, GLM, MiniMax, Grok. A Gemini modellek ebben a formátumban nem érhetők el.

• inputstring | arraykötelező

  A kérés szövege vagy üzenetek és részek tömbje (szöveg, képek).

• instructionsstringnem kötelező

  Rendszerutasítás.

• streambooleannem kötelező

  SSE-eseményfolyam; az utolsó esemény: response.completed. A díjköteles szöveg a költség kiszámítása után egyetlen blokkban érkezik.

• max_output_tokensintegernem kötelező

  A válasz tokenjeinek maximális száma, beleértve a következtetést is. Ha nincs megadva, az Ailoot 4096-ot állít be (vagy kevesebbet, ha a modell válaszkorlátja alacsonyabb). Hosszú válaszokhoz adja meg a korlátot kifejezetten. A következőt tartalmazó kérések: previous_response_id és a beépített eszközöket használók: web_search vagy code_interpreter esetén az új szöveges kéréseknél a megőrzött kontextust és az eszközök használatát külön becslés alapján vesszük figyelembe; a teljes bemeneti ablak költségét nem alkalmazzuk automatikusan. A korábban elfogadott zárolások eredeti feltételei megmaradnak. Kép-, videó- és hangkimenetnél az eredmény teljes költségét zároljuk. Ha a kiszámított zárolandó összeget nem fedezi a rendelkezésre álló egyenleg vagy a kulcs kerete, támogatott modell és metódus esetén az Ailoot csökkentheti a max_tokens (max_output_tokens Responses esetén) értékét a fedezett szintre, de 256 token vagy az adott metódus ennél magasabb minimuma alá nem csökkenti, és ezt a következő fejlécben jelzi: X-Ailoot-Max-Tokens-Capped. A csökkentés lehetőségét az adott szöveges modellre és metódusra ellenőrizzük. Ez a támogatott Gemini szöveges útvonalakra érvényes natív Gemini és Anthropic Messages formátumban; 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 és Messages formátumban (ahol a modell támogatja őket). Kimenet esetén az új szöveges kérés zárolásához a tipikus válaszhossz és az elfogadott feltételek alapján készül becslés. A kért korlát a következő paraméterrel adható meg: max_tokens (max_output_tokens Responses esetén). A kért korlát nem egyezik meg automatikusan a zárolandó összeg kiszámításához használt tokenszámmal, és nem garantálja a tényleges válaszhosszt olyan modellnél, amelynek hosszkorlátozása nem megbízható. A 4096-os alapérték csak a vonatkozó útvonalakra érvényes; a pontos szabály a modelltől és a metódustól függ.

• reasoningobjectnem kötelező

  {"effort": "low" | "medium" | "high"} következtető modellekhez.

• toolsarraynem kötelező

  A modell által meghívható függvények.

• textobjectnem kötelező

  A válasz formátuma, például {"format": {"type": "json_schema", ...}}.

• temperaturenumbernem kötelező

  A válasz véletlenszerűsége, ha a modell támogatja.

Válasz

• outputarray

  A válasz elemei: üzenetek (message), következtetés, függvényhívások. Az SDK-ban kényelmesen használható az output_text.

• statusstring

  completed, incomplete (elérte a korlátot) vagy failed.

• usageobject

  input_tokens, output_tokens, total_tokens.