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": "Antwoord beknopt.",
    "input": "Wat is het verschil tussen TCP en 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="Antwoord beknopt.",
    input="Wat is het verschil tussen TCP en 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: "Antwoord beknopt.",
  input: "Wat is het verschil tussen TCP en 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 garandeert bezorging en volgorde, UDP niet, maar is wel sneller…" }
      ]
    }
  ],
  "usage": { "input_tokens": 24, "output_tokens": 61, "total_tokens": 85 }
}

Authenticatie

• Authorizationheaderverplicht

  Sleutel in de vorm Bearer sk-…. Ook de headers x-api-key of x-goog-api-key.

Verzoekbody

• modelstringverplicht

  Model-ID met het Responses-formaat. De catalogus bevat er 53: GPT, Claude, DeepSeek, Qwen, Kimi, GLM, MiniMax, Grok. Gemini-modellen zijn niet beschikbaar in dit formaat.

• inputstring | arrayverplicht

  Verzoektekst of een array van berichten en onderdelen (tekst, afbeeldingen).

• instructionsstringoptioneel

  Systeeminstructie.

• streambooleanoptioneel

  Een SSE-gebeurtenisstream; de laatste gebeurtenis is response.completed. Betaalde tekst komt na de kostenberekening als één blok binnen.

• max_output_tokensintegeroptioneel

  Maximumaantal antwoordtokens, inclusief redeneren. Als dit niet is opgegeven, vult Ailoot 4096 in (of minder als de antwoordlimiet van het model lager is). Geef voor lange antwoorden expliciet een limiet op. Verzoeken met previous_response_id en met ingebouwde tools web_search of code_interpreter gebruiken voor nieuwe tekstverzoeken afzonderlijke schattingen van de opgeslagen context en het werk van de tools; ze schakelen niet automatisch over op de kosten van het volledige invoervenster. Eerder geaccepteerde reserveringen behouden hun oorspronkelijke voorwaarden. Voor afbeeldingen, video en audio als output worden de volledige kosten van het resultaat gereserveerd. Als de berekende reservering niet binnen het beschikbare saldo of de sleutellimiet past, kan Ailoot voor een ondersteund model en een ondersteunde methode max_tokens (max_output_tokens bij Responses) verlagen tot de betaalbare omvang, maar niet onder 256 tokens of een hoger minimum voor deze methode, en meldt deze verlaging in de header X-Ailoot-Max-Tokens-Capped. Of verlaging mogelijk is, wordt voor het exacte tekstmodel en de methode gecontroleerd. Dit geldt voor ondersteunde Gemini-tekstroutes in het native Gemini-formaat en in 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 — in de Chat Completions- en Messages-formaten (voor zover het model deze ondersteunt). Output wordt voor de reservering van een nieuw tekstverzoek geschat op basis van een typische antwoordlengte en de geaccepteerde voorwaarden. De gevraagde limiet wordt ingesteld via max_tokens (max_output_tokens bij Responses). De gevraagde limiet is niet automatisch gelijk aan het aantal tokens waarop de reservering is berekend en garandeert geen daadwerkelijke antwoordlengte bij een model zonder betrouwbare begrenzing. De standaardwaarde 4096 geldt alleen voor de bijbehorende routes; de precieze regel hangt af van het model en de methode.

• reasoningobjectoptioneel

  {"effort": "low" | "medium" | "high"} voor redeneermodellen.

• toolsarrayoptioneel

  Functies die het model kan aanroepen.

• textobjectoptioneel

  Antwoordformaat, bijvoorbeeld {"format": {"type": "json_schema", ...}}.

• temperaturenumberoptioneel

  Willekeurigheid van het antwoord, als het model dit ondersteunt.

Antwoord

• outputarray

  Antwoordelementen: berichten (message), redeneringen en functieaanroepen. In SDK’s kun je eenvoudig gebruikmaken van output_text.

• statusstring

  completed, incomplete (de limiet is bereikt) of failed.

• usageobject

  input_tokens, output_tokens, total_tokens.