Source: https://ailoot.ai/docs/nl/api/responses/ Canonical: https://ailoot.ai/docs/nl/api/responses/ Language: nl [API](https://ailoot.ai/docs/nl/) # Responses [Markdown](https://ailoot.ai/docs/nl/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 de headers `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` 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. | | `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.