dokumentation
API

Responses

Markdown

OpenAIs nye format: ét input, typet output, værktøjer og ræsonnering. Det bruges af Codex CLI.

Komplet guide
POSThttps://api.ailoot.ai/v1/responses
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": "Svar kort.",
    "input": "Hvad er forskellen på TCP og UDP?"
  }' 
200 OK
{
  "id": "resp_67f1…",
  "object": "response",
  "status": "completed",
  "model": "gpt-6.1-sol",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        { "type": "output_text", "text": "TCP garanterer levering og rækkefølge, UDP gør ikke, men er hurtigere…" }
      ]
    }
  ],
  "usage": { "input_tokens": 24, "output_tokens": 61, "total_tokens": 85 }
}

Godkendelse

  • Authorizationheaderpåkrævet

    Nøgle i formatet Bearer sk-…. Følgende headers kan også bruges: x-api-key eller x-goog-api-key.

Anmodningens indhold

  • modelstringpåkrævet

    Model-ID med Responses-format. Kataloget har 53: GPT, Claude, DeepSeek, Qwen, Kimi, GLM, MiniMax og Grok. Gemini-modeller er ikke tilgængelige i dette format.

  • inputstring | arraypåkrævet

    Anmodningstekst eller en liste af beskeder og dele (tekst, billeder).

  • instructionsstringvalgfrit

    Systeminstruktion.

  • streambooleanvalgfrit

    SSE-hændelsesstrøm; sidste hændelse er response.completed. Betalt tekst kommer i én blok efter beregning af prisen.

  • max_output_tokensintegervalgfrit

    Det maksimale antal tokens i svaret, inklusive ræsonnering. Hvis det ikke angives, indsætter Ailoot 4096 (eller færre, hvis modellens svargrænse er lavere). Angiv grænsen udtrykkeligt ved lange svar. Anmodninger med previous_response_id og med indbyggede værktøjer web_search eller code_interpreter tager for nye tekstanmodninger højde for separate estimater af gemt kontekst og værktøjernes arbejde; de går ikke automatisk over til prisen for hele inputvinduet. Tidligere accepterede reservationer bevarer deres oprindelige vilkår. For billeder, video og lyd som output reserveres hele prisen for resultatet. Hvis den beregnede reservation ikke kan dækkes af den tilgængelige saldo eller nøglens grænse, kan Ailoot for en understøttet model og metode sænke max_tokens (max_output_tokens i Responses) til en mængde, der kan betales, dog ikke til under 256 tokens eller et højere minimum for den pågældende metode, og angiver det i headeren X-Ailoot-Max-Tokens-Capped. Muligheden for at sænke grænsen kontrolleres for den konkrete tekstmodel og metode. Den anvendes på de understøttede tekstruter for Gemini i det oprindelige Gemini-format og i Anthropic Messages-format; 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 — i Chat Completions- og Messages-formaterne (hvor modellen understøtter dem). Output estimeres i reservationen for en ny tekstanmodning ud fra en typisk svarlængde og de accepterede vilkår. Den ønskede grænse angives med max_tokens (max_output_tokens i Responses). Den ønskede grænse er ikke automatisk lig med det antal tokens, reservationen er beregnet for, og garanterer ikke den faktiske svarlængde hos en model uden pålidelig begrænsning. Standardværdien 4096 anvendes kun for de relevante ruter; den konkrete regel afhænger af modellen og metoden.

  • reasoningobjectvalgfrit

    {"effort": "low" | "medium" | "high"} til ræsonneringsmodeller.

  • toolsarrayvalgfrit

    Funktioner, som modellen kan kalde.

  • textobjectvalgfrit

    Svarformat, for eksempel {"format": {"type": "json_schema", ...}}.

  • temperaturenumbervalgfrit

    Hvor tilfældigt svaret er, hvis modellen understøtter det.

Svar

  • outputarray

    Elementer i svaret: beskeder (message), ræsonnering og funktionskald. I SDK'et er det praktisk at bruge output_text.

  • statusstring

    completed, incomplete (grænsen er nået) eller failed.

  • usageobject

    input_tokens, output_tokens, total_tokens.

Har du stadig spørgsmål? Send Request ID og en beskrivelse — så hjælper vi med at finde ud af det.Kontakt support