Chat Completions
MarkdownModellens svar på en samtale i OpenAI-format. Det vanligste formatet: nesten alle klienter støtter det.
Fullstendig guide
https://api.ailoot.ai/v1/chat/completionscurl 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."}
]
}' from openai import OpenAI
import os
client = OpenAI(max_retries=0,
base_url="https://api.ailoot.ai/v1",
api_key=os.environ["AILOOT_API_KEY"],
)
resp = client.chat.completions.create(
model="claude-sonnet-5-5",
messages=[{"role": "user", "content": "Forklar med to setninger hva et API er."}],
)
print(resp.choices[0].message.content)import OpenAI from "openai";
const client = new OpenAI({ maxRetries: 0,
baseURL: "https://api.ailoot.ai/v1",
apiKey: process.env.AILOOT_API_KEY,
});
const resp = await client.chat.completions.create({
model: "claude-sonnet-5-5",
messages: [{ role: "user", content: "Forklar med to setninger hva et API er." }],
});
console.log(resp.choices[0].message.content);{
"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 headernex-api-keyellerx-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) ogcontent— 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 endeligusagesom 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 medfinish_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,requiredeller 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 imax_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.