dokumentation
API

Responses

Markdown

Det nya OpenAI-formatet: en indatauppsättning, typade utdata, verktyg och resonemang. Det används av Codex CLI.

Fullständig 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": "Svara kortfattat.",
    "input": "Vad skiljer TCP från 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 garanterar leverans och ordning, UDP gör inte det men är snabbare…" }
      ]
    }
  ],
  "usage": { "input_tokens": 24, "output_tokens": 61, "total_tokens": 85 }
}

Autentisering

  • Authorizationheaderobligatoriskt

    Nyckel i formatet Bearer sk-…. Även följande headers kan användas x-api-key eller x-goog-api-key.

Anropskropp

  • modelstringobligatoriskt

    Modell-ID med Responses-format. Katalogen har 53: GPT, Claude, DeepSeek, Qwen, Kimi, GLM, MiniMax och Grok. Gemini-modeller är inte tillgängliga i detta format.

  • inputstring | arrayobligatoriskt

    Anropets text eller en array med meddelanden och delar (text, bilder).

  • instructionsstringvalfritt

    Systeminstruktion.

  • streambooleanvalfritt

    SSE-händelseström; den sista händelsen är response.completed. Betald text levereras i ett enda block efter att kostnaden har beräknats.

  • max_output_tokensintegervalfritt

    Maximalt antal token i svaret, inklusive resonemang. Om gränsen inte anges sätter Ailoot in 4096 (eller mindre om modellens svarsgräns är lägre). Ange gränsen uttryckligen för långa svar. Anrop med previous_response_id och med inbyggda verktyg web_search eller code_interpreter tar för nya textanrop hänsyn till separata uppskattningar av sparad kontext och verktygsarbete; de övergår inte automatiskt till kostnaden för hela indatafönstret. Tidigare accepterade reserveringar behåller sina ursprungliga villkor. För bilder, video och ljud som utdata reserveras hela resultatkostnaden. Om den beräknade reserveringen inte ryms inom tillgängligt saldo eller nyckelns gräns kan Ailoot, för en modell och metod som stöds, sänka max_tokens (max_output_tokens i Responses) till en volym som kan betalas, men inte under 256 token eller en högre miniminivå för den aktuella metoden, och anger detta i headern X-Ailoot-Max-Tokens-Capped. Möjligheten att sänka gränsen kontrolleras för den exakta textmodellen och metoden. Den gäller för de textrutter från Gemini som stöds i eget Gemini-format och 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- och Messages-format (där modellen stöder dem). Utdata uppskattas för reserveringen av ett nytt textanrop utifrån en typisk svarslängd och de accepterade villkoren. Den begärda gränsen anges med max_tokens (max_output_tokens i Responses). Den begärda gränsen är inte automatiskt lika med det tokenantal som reserveringen beräknats för och garanterar inte den faktiska svarslängden hos en modell utan tillförlitlig begränsning. Utgångsvärdet 4096 används endast för de berörda rutterna; den exakta regeln beror på modellen och metoden.

  • reasoningobjectvalfritt

    {"effort": "low" | "medium" | "high"} för resonerande modeller.

  • toolsarrayvalfritt

    Funktioner som modellen kan anropa.

  • textobjectvalfritt

    Svarsformat, till exempel {"format": {"type": "json_schema", ...}}.

  • temperaturenumbervalfritt

    Slumpmässighet i svaret, om modellen stöder det.

Svar

  • outputarray

    Svaret innehåller: meddelanden (message), resonemang och funktionsanrop. I SDK:n kan du enkelt hämta output_text.

  • statusstring

    completed, incomplete (gränsen nåddes) eller failed.

  • usageobject

    input_tokens, output_tokens, total_tokens.

Har du fler frågor? Skicka Request ID och en beskrivning, så hjälper vi dig.Kontakta supporten