Source: https://ailoot.ai/docs/nl-be/api/responses/ Canonical: https://ailoot.ai/docs/nl-be/api/responses/ Language: nl-be [API](https://ailoot.ai/docs/nl-be/) # Responses [Markdown](https://ailoot.ai/docs/nl-be/api/responses/index.md) Het nieuwe OpenAI-formaat: één invoer, getypeerde output, tools en redeneren. Codex CLI gebruikt dit. 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": "Antwoord beknopt.", "input": "Wat is het verschil tussen TCP en 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="Antwoord beknopt.", input="Wat is het verschil tussen TCP en 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: "Antwoord beknopt.", input: "Wat is het verschil tussen TCP en 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 garandeert bezorging en volgorde, UDP niet, maar is wel sneller…" } ] } ], "usage": { "input_tokens": 24, "output_tokens": 61, "total_tokens": 85 } } ``` ## Authenticatie | Parameter | Type | Verplicht | Beschrijving | | --- | --- | --- | --- | | `Authorization` | header | verplicht | Sleutel in de vorm `Bearer sk-…`. Ook deze headers worden ondersteund: `x-api-key` of `x-goog-api-key`. | ## Verzoekbody | Parameter | Type | Verplicht | Beschrijving | | --- | --- | --- | --- | | `model` | string | verplicht | 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. | | `input` | string \| array | verplicht | Verzoektekst of een array van berichten en onderdelen (tekst, afbeeldingen). | | `instructions` | string | optioneel | Systeeminstructie. | | `stream` | boolean | optioneel | Een SSE-gebeurtenisstream; de laatste gebeurtenis is `response.completed`. Betaalde tekst komt na de kostenberekening als één blok binnen. | | `max_output_tokens` | integer | optioneel | 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. | | `reasoning` | object | optioneel | `{"effort": "low" \| "medium" \| "high"}` voor redeneermodellen. | | `tools` | array | optioneel | Functies die het model kan aanroepen. | | `text` | object | optioneel | Antwoordformaat, bijvoorbeeld `{"format": {"type": "json_schema", ...}}`. | | `temperature` | number | optioneel | Willekeurigheid van het antwoord, als het model dit ondersteunt. | ## Antwoord | Parameter | Type | Verplicht | Beschrijving | | --- | --- | --- | --- | | `output` | array | | Antwoordelementen: berichten (`message`), redeneringen en functieaanroepen. In SDK’s kun je eenvoudig gebruikmaken van `output_text`. | | `status` | string | | `completed`, `incomplete` (de limiet is bereikt) of `failed`. | | `usage` | object | | `input_tokens`, `output_tokens`, `total_tokens`. | Nog vragen? Stuur de Request ID en een beschrijving — we helpen je verder.[Contact opnemen met support](mailto:support@ailoot.ai) ## Ailoot · Het bedrijf en zijn projectenportefeuille Ailoot bouwt op opgebouwde operationele ervaring, een groot klantenbestand, een stabiele dienst en doorlopende KPI-controle. Het bedrijf en zijn projectenportefeuille: miljoenen klanten; maandelijkse verkopen in de miljarden. Ailoot gebruikt die operationele ervaring voor API-toegang tot AI-functies in klantproducten, agents, applicaties en automatiseringen.