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 deze headers worden ondersteund: 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 houden voor nieuwe tekstverzoeken rekening met afzonderlijke schattingen van de opgeslagen context en het gebruik van tools; ze vallen niet automatisch terug op de kosten van het volledige invoervenster. Voor eerder aanvaarde reserveringen blijven de oorspronkelijke voorwaarden gelden. Voor afbeeldingen, video en audio als uitvoer 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 het betaalbare niveau, maar niet onder 256 tokens of, als dat hoger ligt, het minimum voor die methode. Een verlaging wordt vermeld in de header X-Ailoot-Max-Tokens-Capped. De mogelijkheid om de limiet te verlagen wordt nagegaan voor het specifieke tekstmodel en de specifieke methode. Deze verlaging geldt voor de ondersteunde tekstroutes van Gemini in het native Gemini-formaat en in het Anthropic Messages-formaat; 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 geraamd op basis van een typische antwoordlengte en de aanvaarde voorwaarden. De gevraagde limiet wordt ingesteld met max_tokens (max_output_tokens bij Responses). De gevraagde limiet is niet automatisch gelijk aan het aantal tokens waarop de reservering is berekend en biedt bij een model zonder betrouwbare begrenzing geen garantie voor de werkelijke antwoordlengte. De standaardwaarde 4096 wordt alleen toegepast op de betrokken 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.