Source: https://ailoot.ai/docs/sk/api/responses/
Canonical: https://ailoot.ai/docs/sk/api/responses/
Language: sk

[API](https://ailoot.ai/docs/sk/) 

# Responses

[Markdown](https://ailoot.ai/docs/sk/api/responses/index.md)

Nový formát OpenAI: jeden vstup, typovaný výstup, nástroje a uvažovanie. Používa ho Codex CLI.

POST`https://api.ailoot.ai/v1/responses`

Responses

```bash
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?"
  }' 
```

```python
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)
```

```js
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);
```

200 OK

```json
{
  "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

| Parameter | Typ | Povinný | Popis |
| --- | --- | --- | --- |
| `Authorization` | header | povinné | Kľúč vo formáte `Bearer sk-…`. Možno použiť aj hlavičky `x-api-key` alebo `x-goog-api-key`. |

## Telo požiadavky

| Parameter | Typ | Povinný | Popis |
| --- | --- | --- | --- |
| `model` | string | povinné | 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é. |
| `input` | string \| array | povinné | Text požiadavky alebo pole správ a častí (text, obrázky). |
| `instructions` | string | voliteľné | Systémová inštrukcia. |
| `stream` | boolean | voliteľné | Stream udalostí SSE; poslednou udalosťou je `response.completed`. Platený text príde v jednom bloku po výpočte ceny. |
| `max_output_tokens` | integer | voliteľ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. |
| `reasoning` | object | voliteľné | `{"effort": "low" \| "medium" \| "high"}` pre modely s uvažovaním. |
| `tools` | array | voliteľné | Funkcie, ktoré môže model zavolať. |
| `text` | object | voliteľné | Formát odpovede, napríklad `{"format": {"type": "json_schema", ...}}`. |
| `temperature` | number | voliteľné | Miera náhodnosti odpovede, ak ju model podporuje. |

## Odpoveď

| Parameter | Typ | Povinný | Popis |
| --- | --- | --- | --- |
| `output` | array |  | Prvky odpovede: správy (`message`), uvažovanie, volania funkcií. V SDK je praktické použiť `output_text`. |
| `status` | string |  | `completed`, `incomplete` (dosiahol sa limit) alebo `failed`. |
| `usage` | object |  | `input_tokens`, `output_tokens`, `total_tokens`. |

Máte ďalšie otázky? Pošlite Request ID a opis problému – pomôžeme vám ho vyriešiť.[Napísať podpore](mailto:support@ailoot.ai)

## Ailoot · Spoločnosť a jej portfólio projektov





Ailoot stavia na dlhodobých prevádzkových skúsenostiach, širokej klientskej základni, stabilných službách a priebežnom sledovaní KPI.





Spoločnosť a jej portfólio projektov: milióny zákazníkov; mesačné tržby v miliardách.





Ailoot využíva tieto prevádzkové skúsenosti na poskytovanie prístupu cez API k funkciám AI v produktoch zákazníkov, agentoch, aplikáciách a automatizáciách.