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

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

# Responses

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

Nový formát OpenAI: jeden vstup, typovaný výstup, nástroje a uvažování. Používá jej 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": "Odpovídej stručně.",
    "input": "Jaký je rozdíl mezi TCP a 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="Odpovídej stručně.",
    input="Jaký je rozdíl mezi TCP a 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: "Odpovídej stručně.",
  input: "Jaký je rozdíl mezi TCP a 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čení a pořadí, UDP nikoli, ale je rychlejší…" }
      ]
    }
  ],
  "usage": { "input_tokens": 24, "output_tokens": 61, "total_tokens": 85 }
}
```

## Autorizace

| Parametr | Typ | Povinný | Popis |
| --- | --- | --- | --- |
| `Authorization` | header | povinný | Klíč ve tvaru `Bearer sk-…`. Lze použít také hlavičky `x-api-key` nebo `x-goog-api-key`. |

## Tělo požadavku

| Parametr | Typ | Povinný | Popis |
| --- | --- | --- | --- |
| `model` | string | povinný | ID modelu s formátem Responses. Takových je v katalogu 53: GPT, Claude, DeepSeek, Qwen, Kimi, GLM, MiniMax, Grok. Modely Gemini nejsou v tomto formátu dostupné. |
| `input` | string \| array | povinný | Text požadavku nebo pole zpráv a částí (text, obrázky). |
| `instructions` | string | nepovinný | Systémový pokyn. |
| `stream` | boolean | nepovinný | Proud událostí SSE; poslední událost – `response.completed`. Placený text přichází v jednom bloku po výpočtu ceny. |
| `max_output_tokens` | integer | nepovinný | Maximální počet tokenů odpovědi včetně uvažování. Pokud není uveden, Ailoot doplní 4096 (nebo méně, pokud má model nižší limit odpovědi). Pro dlouhé odpovědi nastavte limit výslovně. Požadavky s `previous_response_id` a s vestavěnými nástroji `web_search` nebo `code_interpreter` u nových textových požadavků zohledňují samostatné odhady uloženého kontextu a práce nástrojů; automaticky nepřecházejí na cenu celého vstupního okna. Dříve přijaté rezervace si zachovávají původní podmínky. U obrázků, videa a zvuku na výstupu se rezervuje celá cena výsledku. Pokud se vypočtená rezervace nevejde do dostupného zůstatku nebo limitu klíče, může Ailoot u podporovaného modelu a metody snížit `max_tokens` (`max_output_tokens` v Responses) na zaplatitelný objem, ne však pod 256 tokenů ani pod vyšší minimum dané metody, a oznámí to v hlavičce `X-Ailoot-Max-Tokens-Capped`. Možnost snížení se ověřuje pro konkrétní textový model a metodu. Platí pro podporované textové trasy Gemini v nativním formátu Gemini a ve formátu 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` – ve formátech Chat Completions a Messages (tam, kde je model podporuje). **Výstup** – pro rezervaci nového textového požadavku se odhaduje podle obvyklé délky odpovědi a přijatých podmínek. Požadovaný limit se zadává prostřednictvím `max_tokens` (`max_output_tokens` v Responses). Požadovaný limit se automaticky nerovná počtu tokenů použitému k výpočtu rezervace a u modelu bez spolehlivého omezení nezaručuje skutečnou délku odpovědi. Výchozí hodnota 4096 se používá pouze u příslušných tras; konkrétní pravidlo závisí na modelu a metodě. |
| `reasoning` | object | nepovinný | `{"effort": "low" \| "medium" \| "high"}` pro modely s uvažováním. |
| `tools` | array | nepovinný | Funkce, které model může vyvolat. |
| `text` | object | nepovinný | Formát odpovědi, například `{"format": {"type": "json_schema", ...}}`. |
| `temperature` | number | nepovinný | Náhodnost odpovědi, pokud ji model podporuje. |

## Odpověď

| Parametr | Typ | Povinný | Popis |
| --- | --- | --- | --- |
| `output` | array |  | Prvky odpovědi: zprávy (`message`), uvažování, volání funkcí. V SDK je vhodné použít `output_text`. |
| `status` | string |  | `completed`, `incomplete` (dosáhl limitu) nebo `failed`. |
| `usage` | object |  | `input_tokens`, `output_tokens`, `total_tokens`. |

Máte další dotazy? Pošlete Request ID a popis – pomůžeme situaci objasnit.[Napsat podpoře](mailto:support@ailoot.ai)

## Ailoot · Společnost a její portfolio projektů





Ailoot staví na dlouhodobých provozních zkušenostech, široké klientské základně, stabilních službách a průběžném sledování KPI.





Společnost a její portfolio projektů: miliony zákazníků; měsíční tržby v miliardách.





Ailoot využívá tyto provozní zkušenosti k poskytování přístupu přes API k funkcím AI v produktech zákazníků, agentech, aplikacích a automatizacích.
