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

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

# Responses

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

Novi format OpenAI: en vhod, tipiziran izhod, orodja in sklepanje. Uporablja ga 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": "Odgovarjaj na kratko.",
    "input": "Kakšna je razlika med TCP in 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="Odgovarjaj na kratko.",
    input="Kakšna je razlika med TCP in 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: "Odgovarjaj na kratko.",
  input: "Kakšna je razlika med TCP in 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 zagotavlja dostavo in pravilen vrstni red, UDP pa ne, vendar je hitrejši…" }
      ]
    }
  ],
  "usage": { "input_tokens": 24, "output_tokens": 61, "total_tokens": 85 }
}
```

## Avtentikacija

| Parameter | Tip | Obvezen | Opis |
| --- | --- | --- | --- |
| `Authorization` | header | obvezno | Ključ v obliki `Bearer sk-…`. Uporabite lahko tudi glavi `x-api-key` ali `x-goog-api-key`. |

## Telo zahteve

| Parameter | Tip | Obvezen | Opis |
| --- | --- | --- | --- |
| `model` | string | obvezno | 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. |
| `input` | string \| array | obvezno | Besedilo zahteve ali polje sporočil in delov (besedilo, slike). |
| `instructions` | string | neobvezno | Sistemsko navodilo. |
| `stream` | boolean | neobvezno | Tok dogodkov SSE; zadnji dogodek je `response.completed`. Plačljivo besedilo prispe v enem bloku po izračunu stroškov. |
| `max_output_tokens` | integer | neobvezno | 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. |
| `reasoning` | object | neobvezno | `{"effort": "low" \| "medium" \| "high"}` za modele za sklepanje. |
| `tools` | array | neobvezno | Funkcije, ki jih model lahko pokliče. |
| `text` | object | neobvezno | Format odgovora, na primer `{"format": {"type": "json_schema", ...}}`. |
| `temperature` | number | neobvezno | Naključnost odgovora, če jo model podpira. |

## Odgovor

| Parameter | Tip | Obvezen | Opis |
| --- | --- | --- | --- |
| `output` | array |  | Elementi odgovora: sporočila (`message`), sklepanje, klici funkcij. V SDK je priročno uporabiti `output_text`. |
| `status` | string |  | `completed`, `incomplete` (dosežena omejitev) ali `failed`. |
| `usage` | object |  | `input_tokens`, `output_tokens`, `total_tokens`. |

Imate še vprašanja? Pošljite Request ID in opis – pomagali vam bomo razjasniti težavo.[Pišite podpori](mailto:support@ailoot.ai)

## Ailoot · Podjetje in njegov portfelj projektov





Ailoot temelji na pridobljenih operativnih izkušnjah, široki bazi strank, stabilni storitvi in stalnem spremljanju KPI.





Podjetje in njegov portfelj projektov: milijoni strank; mesečna prodaja v milijardah.





Ailoot te operativne izkušnje uporablja za dostop prek API do funkcij umetne inteligence v izdelkih strank, agentih, aplikacijah in avtomatizacijah.