Source: https://ailoot.ai/docs/fr/how-it-works/
Canonical: https://ailoot.ai/docs/fr/how-it-works/
Language: fr

[Premiers pas](https://ailoot.ai/docs/fr/) 

# Fonctionnement

[Markdown](https://ailoot.ai/docs/fr/how-it-works/index.md)

Ce qui se passe entre votre application et le modèle lorsqu’une requête est envoyée.

Vous envoyez une requête à l’API Ailoot comme si vous l’envoyiez directement à OpenAI, Anthropic ou Google. Ailoot vérifie la clé et le solde, transmet la requête au modèle, renvoie la réponse au même format et débite le montant selon la consommation réelle.

<em>01</em><strong>Requête</strong>Votre client envoie une requête à api.ailoot.ai avec une clé sk-…

<em>02</em><strong>Vérification et réservation</strong>Clé, plafonds, solde. Un montant est réservé pendant la préparation de la réponse.

<em>03</em><strong>Modèle</strong>Le modèle répond et la réponse est renvoyée dans votre format.

<em>04</em><strong>Débit</strong>Un seul débit selon les tokens réellement utilisés ; le reste de la réservation est libéré.

## [](https://ailoot.ai/docs/fr/how-it-works/#formats)Une clé, trois formats

Le format dépend du chemin de la requête, et non du modèle. Vous pouvez appeler un même modèle Claude via OpenAI Chat, OpenAI Responses ou Anthropic Messages : la réponse utilise le format du chemin appelé.

| Format | Chemin | Clients qui l’utilisent |
| --- | --- | --- |
| OpenAI Chat Completions | `/v1/chat/completions` | OpenAI SDK, la plupart des chats et éditeurs, n8n, LangChain |
| OpenAI Responses | `/v1/responses` | Codex CLI, OpenAI Agents SDK, versions récentes des SDK |
| Anthropic Messages | `/v1/messages` | Claude Code, Anthropic SDK, Zed, Cline |
| Gemini | `/v1beta/models/{model}:generateContent` | Gemini CLI, Google GenAI SDK |

## [](https://ailoot.ai/docs/fr/how-it-works/#money)Montants : réservation et débit unique

- Avant l’envoi d’une nouvelle requête textuelle, Ailoot réserve un montant estimé pour l’entrée et une réponse typique, en tenant compte de la limite (`max_tokens`) et des conditions du modèle précis. Si la réservation ne peut pas être couverte par le solde libre ou le plafond de la clé, la limite transmise ne peut être réduite que pour un modèle et une méthode qui la respectent réellement, sans descendre sous 256 tokens ni sous le minimum de réponse défini. Pour les images, la vidéo et l’audio en sortie, la réservation couvre toujours le coût total du résultat.
- Après la réponse, un seul débit est effectué selon la consommation réelle. La part inutilisée de la réservation est immédiatement rendue disponible sur le solde.
- Si la réponse coûte plus que la réservation, la différence est prélevée sur le solde disponible. Le solde ne devient jamais négatif.
- Si le solde ne couvre même pas la réservation minimale, la requête n’est pas envoyée : vous recevez une erreur 402 explicite et aucun montant n’est débité.
- Une erreur qui ne produit aucun résultat n’est pas facturée.

Les détails et un exemple de calcul figurent sur la page [Réservation et débit](https://ailoot.ai/docs/fr/billing/reserve/).

## [](https://ailoot.ai/docs/fr/how-it-works/#errors)Erreurs avec Request ID

Chaque réponse reçoit un identifiant de requête, dans l’en-tête `X-Request-ID` et dans le texte de l’erreur. Les erreurs sont au format JSON de l’API appelée, afin que les SDK les reconnaissent correctement. En cas de problème, transmettez le Request ID à [l’assistance](https://ailoot.ai/docs/fr/support/) — nous pourrons ainsi retrouver la requête en une minute.

401 Unauthorized

```json
{
  "code": "API_KEY_REQUIRED",
  "error": {
    "code": "invalid_api_key",
    "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer <key>\". Request ID: 3b28d3de-5b02-4d07-9f3c-4b9a7d0e68d6.",
    "param": null,
    "reason": "invalid_api_key",
    "request_id": "3b28d3de-5b02-4d07-9f3c-4b9a7d0e68d6",
    "type": "invalid_request_error"
  },
  "message": "No API key was sent with the request. Nothing was charged. …"
}
```

## [](https://ailoot.ai/docs/fr/how-it-works/#streaming)Streaming et délais d’attente

Les réponses en streaming (`stream: true`) utilisent Server-Sent Events. Ailoot fournit la réponse textuelle payante après le calcul du coût. Ainsi, avec `stream: true` , le format reste un flux SSE, mais le texte arrive en un seul bloc lorsque le modèle a terminé, et non mot à mot. Si la réponse prend plus d’environ 15 secondes, les flux Chat Completions, Responses et Messages commencent par des lignes de service `: ping` (environ toutes les 10 secondes), puis la ligne `: ailoot-charged-usd …` avec le montant débité, suivie des données. Les SDK ignorent ces lignes.

Le format Gemini ne contient pas de lignes de service : la réponse `:streamGenerateContent` arrive en entier après le calcul. Prévoyez une marge dans le délai d’attente du client pour les modèles de raisonnement : plusieurs minutes sont normales.

## [](https://ailoot.ai/docs/fr/how-it-works/#headers)En-têtes de réponse

`X-Request-ID` est présent dans chaque réponse. Ailoot ajoute les autres en-têtes aux réponses textuelles payantes :

| En-tête | Contenu |
| --- | --- |
| `X-Request-ID` | Identifiant de la requête, demandé par l’assistance |
| `X-Ailoot-Charged-USD` | Montant débité pour cette requête, en dollars |
| `X-Ailoot-Output-Tokens` | Nombre de tokens de réponse facturés |
| `X-Ailoot-Max-Tokens-Capped` | Limite de réponse réduite parce que le solde ne couvrait pas la réservation complète |
| `X-Ailoot-Notice-Code`, `X-Ailoot-Notice` | Explication si la réponse s’est arrêtée à la limite de longueur |

Si le flux a déjà commencé par des lignes de service, ces informations sont transmises dans une ligne de commentaire avant les données, et non dans un en-tête.

## [](https://ailoot.ai/docs/fr/how-it-works/#cache)Cache des prompts

Si le modèle prend en charge le cache, renvoyer un long préfixe, comme une instruction système ou des documents, peut coûter moins cher. Les tarifs de lecture et d’écriture du cache figurent dans la fiche du modèle dans [catalogue](https://ailoot.ai/models/fr/). Le développeur du modèle décide de l’utilisation du cache ; Ailoot ne la garantit pas.

Encore des questions ? Envoyez le Request ID et une description : nous vous aiderons à comprendre.[Contacter l’assistance](mailto:support@ailoot.ai)

## Ailoot · L’entreprise et son portefeuille de projets





Ailoot s’appuie sur une expérience opérationnelle éprouvée, une large clientèle, un service stable et un suivi continu des KPI.





L’entreprise et son portefeuille de projets : des millions de clients ; des ventes qui se chiffrent en milliards chaque mois.





Ailoot met cette expérience opérationnelle au service de l’accès API aux fonctions d’IA dans les produits des clients, leurs agents, applications et automatisations.