dokumentasjon
API

Responses

Markdown

Det nye OpenAI-formatet: ett inndatasett, typede utdata, verktøy og resonnering. Det brukes av Codex CLI.

Fullstendig 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 kortfattet.",
    "input": "Hva er forskjellen 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 rekkefølge; UDP gjør ikke det, men er raskere…" }
      ]
    }
  ],
  "usage": { "input_tokens": 24, "output_tokens": 61, "total_tokens": 85 }
}

Autentisering

  • Authorizationheaderpåkrevd

    Nøkkel i formatet Bearer sk-…. Du kan også bruke headerne x-api-key eller x-goog-api-key.

Forespørselskropp

  • modelstringpåkrevd

    Modell-ID med Responses-format. Katalogen har 53: GPT, Claude, DeepSeek, Qwen, Kimi, GLM, MiniMax og Grok. Gemini-modeller er ikke tilgjengelige i dette formatet.

  • inputstring | arraypåkrevd

    Forespørselstekst eller en liste med meldinger og deler (tekst, bilder).

  • instructionsstringvalgfri

    Systeminstruksjon.

  • streambooleanvalgfri

    SSE-hendelsesstrøm; den siste hendelsen er response.completed. Betalt tekst leveres som én blokk etter at kostnaden er beregnet.

  • max_output_tokensintegervalgfri

    Maksimalt antall svartokener, inkludert resonnering. Hvis grensen ikke er angitt, setter Ailoot inn 4096 (eller mindre hvis modellens svargrense er lavere). Angi grensen eksplisitt for lange svar. Forespørsler med previous_response_id og med de innebygde verktøyene web_search eller code_interpreter bruker for nye tekstforespørsler separate anslag for lagret kontekst og verktøybruk; de går ikke automatisk over til kostnaden for hele inndatavinduet. Tidligere godtatte reservasjoner beholder de opprinnelige vilkårene. For bilder, video og lyd som utdata reserveres hele resultatkostnaden. Hvis den beregnede reservasjonen ikke dekkes av tilgjengelig saldo eller nøkkelgrensen, kan Ailoot for en støttet modell og metode redusere max_tokens (max_output_tokens i Responses) til et omfang som kan betales, men ikke under 256 tokener eller et høyere minimum for denne metoden, og opplyser om dette i headeren X-Ailoot-Max-Tokens-Capped. Om grensen kan reduseres, kontrolleres for den konkrete tekstmodellen og metoden. Dette gjelder støttede Gemini-tekstruter i det native Gemini-formatet 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-format (der modellen støtter disse). Utdata anslås for reservasjonen av en ny tekstforespørsel ut fra en typisk svarlengde og de godtatte vilkårene. Den forespurte grensen angis via max_tokens (max_output_tokens i Responses). Den forespurte grensen er ikke automatisk lik antallet tokener reservasjonen er beregnet etter, og garanterer ikke svarets faktiske lengde for en modell uten pålitelig begrensning. Standardverdien 4096 gjelder bare for de aktuelle rutene; den konkrete regelen avhenger av modellen og metoden.

  • reasoningobjectvalgfri

    {"effort": "low" | "medium" | "high"} for resonnerende modeller.

  • toolsarrayvalgfri

    Funksjoner modellen kan kalle.

  • textobjectvalgfri

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

  • temperaturenumbervalgfri

    Tilfeldighet i svaret, hvis modellen støtter det.

Svar

  • outputarray

    Svarelementer: meldinger (message), resonnering og funksjonskall. I SDK-et kan du enkelt hente output_text.

  • statusstring

    completed, incomplete (nådde grensen) eller failed.

  • usageobject

    input_tokens, output_tokens, total_tokens.

Flere spørsmål? Send Request ID og en beskrivelse, så hjelper vi deg.Kontakt brukerstøtte