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": "Explique en deux phrases ce qu’est une API."}
    ]
  }' 

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": "Explique en deux phrases ce qu’est une API."}],
)
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: "Explique en deux phrases ce qu’est une API." }],
});
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": "Une API est une convention qui définit comment un programme demande à un autre d’effectuer une action…"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 21,
    "completion_tokens": 48,
    "total_tokens": 69
  }
}

Autorisation

• Authorizationheaderobligatoire

  Clé au format Bearer sk-…. Les en-têtes suivants conviennent également : x-api-key ou x-goog-api-key.

Corps de la requête

• modelstringobligatoire

  ID du modèle issu du catalogue, par exemple claude-sonnet-5-5. Le modèle doit prendre en charge le format OpenAI Chat.

• messagesarrayobligatoire

  Historique de la conversation : objets avec role (system, developer, user, assistant, tool) et content — sous forme de chaîne ou de tableau de parties (texte, image_url).

• streambooleanfacultatif

  Réponse au format Server-Sent Events. Par défaut false. Le texte facturé arrive en un seul bloc après le calcul du coût, et non mot par mot.

• stream_optionsobjectfacultatif

  {"include_usage": true} — envoyer les données finales du champ usage comme dernier événement du flux.

• max_tokensintegerfacultatif

  Nombre maximal de tokens de réponse. Le nouveau nom est max_completion_tokens. Si aucune limite n’est définie, Ailoot utilise 4096 (ou moins si la limite de réponse du modèle est plus faible ; Grok a sa propre limite). Pour les réponses longues, définissez explicitement la limite, sinon la réponse s’arrêtera à 4096 tokens avec finish_reason: "length". Cette limite est prise en compte dans le montant réservé : plus elle est élevée, plus le solde disponible nécessaire est important.

• temperaturenumberfacultatif

  Degré d’aléatoire de la réponse, généralement de 0 à 2. Les modèles de raisonnement peuvent ignorer ce paramètre.

• top_pnumberfacultatif

  Alternative à temperature : part de la masse de probabilité utilisée pour choisir les tokens.

• stopstring | arrayfacultatif

  Chaînes de texte qui arrêtent la génération.

• toolsarrayfacultatif

  Descriptions des fonctions que le modèle peut appeler. Le format est celui d’OpenAI : {"type": "function", "function": {...}}.

• tool_choicestring | objectfacultatif

  auto, none, required ou une fonction précise.

• response_formatobjectfacultatif

  {"type": "json_object"} ou {"type": "json_schema", ...} pour une réponse structurée, si le modèle le permet.

• reasoning_effortstringfacultatif

  Profondeur du raisonnement pour les modèles de raisonnement : low, medium, high.

Les autres paramètres OpenAI sont transmis tels quels. Le développeur du modèle détermine si ce modèle les prend en charge.

Réponse

• choices[].messageobject

  Réponse du modèle : content, lors d’un appel d’outils : tool_calls.

• choices[].finish_reasonstring

  stop — réponse terminée ; length — limite atteinte pour max_tokens (la réponse reste complète et est facturée selon l’utilisation réelle) ; tool_calls — le modèle appelle un outil.

• usageobject

  prompt_tokens, completion_tokens, total_tokens — ces valeurs servent à calculer le débit.