dokumentation
API

Chat Completions

Markdown

Modellens svar på en samtale i OpenAI-format. Det mest udbredte format: næsten alle klienter forstår det.

Komplet 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 sætninger, hvad 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 aftale om, hvordan et program beder et andet om at gøre noget…"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 21,
    "completion_tokens": 48,
    "total_tokens": 69
  }
}

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 fra kataloget, for eksempel claude-sonnet-5-5. Modellen skal understøtte OpenAI Chat-formatet.

  • messagesarraypåkrævet

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

  • streambooleanvalgfrit

    Svar i Server-Sent Events-format. Som standard false. Betalt tekst kommer i én blok efter beregning af prisen, ikke ord for ord.

  • stream_optionsobjectvalgfrit

    {"include_usage": true} — send det endelige usage som strømmens sidste hændelse.

  • max_tokensintegervalgfrit

    Det maksimale antal tokens i svaret. Det nye navn er max_completion_tokens. Hvis grænsen ikke angives, indsætter Ailoot 4096 (eller færre, hvis modellens svargrænse er lavere; Grok har sin egen grænse). Angiv grænsen udtrykkeligt ved lange svar, ellers stopper svaret ved 4096 tokens med finish_reason: "length". Grænsen indgår i reservationen: jo højere den er, desto større ledig saldo kræves.

  • temperaturenumbervalgfrit

    Hvor tilfældigt svaret er, normalt fra 0 til 2. Kan blive ignoreret af ræsonneringsmodeller.

  • top_pnumbervalgfrit

    Alternativ til temperature: den andel af sandsynlighedsmassen, der bruges til at vælge tokens.

  • stopstring | arrayvalgfrit

    Strenge, som får genereringen til at stoppe.

  • toolsarrayvalgfrit

    Beskrivelser af funktioner, som modellen kan kalde. Formatet er som hos OpenAI: {"type": "function", "function": {...}}.

  • tool_choicestring | objectvalgfrit

    auto, none, required eller en bestemt funktion.

  • response_formatobjectvalgfrit

    {"type": "json_object"} eller {"type": "json_schema", ...} til et struktureret svar — hvis modellen understøtter det.

  • reasoning_effortstringvalgfrit

    Ræsonneringsdybde for ræsonneringsmodeller: low, medium, high.

De øvrige OpenAI-parametre videresendes uændret; det er modellens udvikler, der afgør, om den enkelte model understøtter dem.

Svar

  • choices[].messageobject

    Modellens svar: content, ved værktøjskald — tool_calls.

  • choices[].finish_reasonstring

    stop — svaret er afsluttet; length — grænsen max_tokens er nået (svaret er stadig fuldstændigt og betales efter det faktiske forbrug); tool_calls — modellen kalder et værktøj.

  • usageobject

    prompt_tokens, completion_tokens, total_tokens — de bruges til at beregne debiteringen.

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