dokumentasjon
API

Chat Completions

Markdown

Modellens svar på en samtale i OpenAI-format. Det vanligste formatet: nesten alle klienter støtter det.

Fullstendig guide
POSThttps://api.ailoot.ai/v1/chat/completions
Chat Completions
curl https://api.ailoot.ai/v1/chat/completions \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "messages": [
      {"role": "user", "content": "Forklar med to setninger hva et API er."}
    ]
  }' 
200 OK
{
  "id": "chatcmpl-8f2c…",
  "object": "chat.completion",
  "created": 1790812800,
  "model": "claude-sonnet-5-5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "API er en avtale om hvordan ett program ber et annet om å gjøre noe…"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 21,
    "completion_tokens": 48,
    "total_tokens": 69
  }
}

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 fra katalogen, for eksempel claude-sonnet-5-5. Modellen må støtte OpenAI Chat-formatet.

  • messagesarraypåkrevd

    Samtalehistorikk: objekter med role (system, developer, user, assistant, tool) og content — en streng eller en liste med deler (tekst, image_url).

  • streambooleanvalgfri

    Svar i Server-Sent Events-format. Standardverdien er false. Betalt tekst leveres som én blokk etter at kostnaden er beregnet, ikke ord for ord.

  • stream_optionsobjectvalgfri

    {"include_usage": true} — send endelig usage som den siste hendelsen i strømmen.

  • max_tokensintegervalgfri

    Maksimalt antall svartokener. Det nye navnet er max_completion_tokens. Hvis ingen grense er angitt, setter Ailoot inn 4096 (eller mindre hvis modellens svargrense er lavere; Grok har sin egen grense). Angi grensen eksplisitt for lange svar, ellers stopper svaret ved 4096 tokener med finish_reason: "length". Grensen inngår i reservasjonen: jo høyere den er, desto større tilgjengelig saldo trenger du.

  • temperaturenumbervalgfri

    Tilfeldighet i svaret, vanligvis fra 0 til 2. Kan ignoreres av resonnerende modeller.

  • top_pnumbervalgfri

    Alternativ til temperature: andelen av sannsynlighetsmassen som brukes til å velge tokener.

  • stopstring | arrayvalgfri

    Strenger som stopper genereringen.

  • toolsarrayvalgfri

    Beskrivelser av funksjoner modellen kan kalle. Formatet er som hos OpenAI: {"type": "function", "function": {...}}.

  • tool_choicestring | objectvalgfri

    auto, none, required eller en bestemt funksjon.

  • response_formatobjectvalgfri

    {"type": "json_object"} eller {"type": "json_schema", ...} for et strukturert svar — hvis modellen støtter det.

  • reasoning_effortstringvalgfri

    Resonneringsdybde for resonnerende modeller: low, medium, high.

Andre OpenAI-parametere videresendes uendret; modellutvikleren avgjør om den enkelte modellen støtter dem.

Svar

  • choices[].messageobject

    Modellens svar: content, ved verktøykall — tool_calls.

  • choices[].finish_reasonstring

    stop — svaret er ferdig; length — nådde grensen i max_tokens (et slikt svar regnes likevel som komplett og belastes etter faktisk forbruk); tool_calls — modellen kaller et verktøy.

  • usageobject

    prompt_tokens, completion_tokens, total_tokens — disse brukes til å beregne belastningen.

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