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": "Odpovídej stručně.",
    "input": "Jaký je rozdíl mezi TCP a 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="Odpovídej stručně.",
    input="Jaký je rozdíl mezi TCP a 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: "Odpovídej stručně.",
  input: "Jaký je rozdíl mezi TCP a 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 zaručuje doručení a pořadí, UDP nikoli, ale je rychlejší…" }
      ]
    }
  ],
  "usage": { "input_tokens": 24, "output_tokens": 61, "total_tokens": 85 }
}

Autorizace

• Authorizationheaderpovinný

  Klíč ve tvaru Bearer sk-…. Lze použít také hlavičky x-api-key nebo x-goog-api-key.

Tělo požadavku

• modelstringpovinný

  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é.

• inputstring | arraypovinný

  Text požadavku nebo pole zpráv a částí (text, obrázky).

• instructionsstringnepovinný

  Systémový pokyn.

• streambooleannepovinný

  Proud událostí SSE; poslední událost – response.completed. Placený text přichází v jednom bloku po výpočtu ceny.

• max_output_tokensintegernepovinný

  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ě.

• reasoningobjectnepovinný

  {"effort": "low" | "medium" | "high"} pro modely s uvažováním.

• toolsarraynepovinný

  Funkce, které model může vyvolat.

• textobjectnepovinný

  Formát odpovědi, například {"format": {"type": "json_schema", ...}}.

• temperaturenumbernepovinný

  Náhodnost odpovědi, pokud ji model podporuje.

Odpověď

• outputarray

  Prvky odpovědi: zprávy (message), uvažování, volání funkcí. V SDK je vhodné použít output_text.

• statusstring

  completed, incomplete (dosáhl limitu) nebo failed.

• usageobject

  input_tokens, output_tokens, total_tokens.