Source: https://ailoot.ai/docs/fr-be/cabinet/
Canonical: https://ailoot.ai/docs/fr-be/cabinet/
Language: fr-be

[API de l’espace client](https://ailoot.ai/docs/fr-be/) 

# API de l’espace client

[Markdown](https://ailoot.ai/docs/fr-be/cabinet/index.md)

Méthodes de l’espace client : connexion, profil, clés et historique des dépenses.

Il s’agit de l’API de l’espace client ailoot.ai : connexion, profil, clés et historique des dépenses. Les requêtes aux modèles utilisent une autre adresse : `https://api.ailoot.ai` avec une clé `sk-…`. L’accès aux méthodes dépend des droits de votre compte et des fonctions activées.

## [](https://ailoot.ai/docs/fr-be/cabinet/#adresa-i-avtorizatsiya)Adresses et authentification

- Espace client : https://ailoot.ai (connexion par identifiants, token de l’espace client)
- API des modèles : https://api.ailoot.ai (clé sk-…)

| Élément | Adresse | Autorisation |
| --- | --- | --- |
| API de l’espace client | `https://ailoot.ai/api/v1` | `Authorization: Bearer $TOKEN` — token de l’espace client obtenu après connexion |
| API des modèles | `https://api.ailoot.ai/v1` | La clé `sk-…` depuis la rubrique « Clés API » ; voir [Clés et URL de l’API](https://ailoot.ai/docs/fr-be/keys/) |

La clé `sk-…` ne remplace pas le token de l’espace client, et ce dernier ne donne pas accès à l’API des modèles. Le chemin complet est précisé pour chaque méthode.

Consulter votre profil

```bash
curl --fail-with-body "https://ailoot.ai/api/v1/user/profile" \
  -H "Authorization: Bearer $TOKEN"
```

## [](https://ailoot.ai/docs/fr-be/cabinet/#format-otveta-i-oshibki)Format de réponse et erreurs

La réponse contient code, message et data. Une erreur peut également contenir reason et metadata. La pagination dans data contient items, total, page, page\_size et pages. Le format de chaque méthode est précisé dans sa description.

Structure d’une réponse paginée

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "items": [],
    "total": 0,
    "page": 1,
    "page_size": 20,
    "pages": 1
  }
}
```

La validité du token de l’espace client et le statut actif de l’utilisateur sont vérifiés ; si la liaison de session est activée, l’IP et le navigateur le sont aussi. Les codes TOKEN\_EXPIRED, TOKEN\_REVOKED, USER\_INACTIVE, INVALID\_TOKEN et FORBIDDEN distinguent les problèmes de session et de droits. Une limite de fréquence et une vérification 2FA supplémentaire peuvent bloquer une requête donnée.

## [](https://ailoot.ai/docs/fr-be/cabinet/#kak-chitat-spravochnik)Comment lire la référence

- Chaque entrée indique la méthode HTTP, le chemin complet, l’accès, les paramètres, les champs du corps et la réponse.
- Utilisez les identifiants de la réponse précédente : KEY\_ID depuis GET /api/v1/keys, et l’ID de requête depuis GET /api/v1/usage.
- Les champs des objets et leurs types figurent sur les pages « Schémas de données ».
- Les modèles présentent les noms et les types des champs. PLACEHOLDER et TOKEN sont des marqueurs ; aucune donnée réelle n’est fournie ici.
- Le rechargement du solde se fait dans la rubrique « Tarifs » de l’espace client : [comment recharger](https://ailoot.ai/docs/fr-be/billing/topup/).

## [](https://ailoot.ai/docs/fr-be/cabinet/#balans-i-frozen-balance)Solde et frozen\_balance

Le profil contient balance et frozen\_balance. frozen\_balance est le montant réservé pour les requêtes en cours. Vérifiez ces deux champs avec l’historique.

## [](https://ailoot.ai/docs/fr-be/cabinet/#klyuchi-i-limity)Clés et plafonds

GET /api/v1/keys renvoie vos clés. Les champs `quota` et `quota_used` — plafond de dépenses de la clé et part déjà dépensée ; `ip_whitelist`, `ip_blacklist`, `status` et `expires_at` contrôlent l’utilisation de la clé ; `rate_limit_5h`, `rate_limit_1d` et `rate_limit_7d` — plafonds de dépenses par fenêtre.

Liste des clés et clé personnelle

```bash
curl --fail-with-body "https://ailoot.ai/api/v1/keys" \
  -H "Authorization: Bearer $TOKEN"

# KEY_ID — id de votre propre clé dans la réponse contenant la liste
curl --fail-with-body "https://ailoot.ai/api/v1/keys/$KEY_ID" \
  -H "Authorization: Bearer $TOKEN"
```

## [](https://ailoot.ai/docs/fr-be/cabinet/#rashody-i-bezopasnost)Dépenses et sécurité

L’historique et le tableau de bord affichent actual\_cost, le débit réel, et total\_cost, le coût au tarif standard. Les filtres de date, de modèle, de clé et de type de requête sont précisés pour chaque méthode. Le changement de mot de passe, TOTP et les clés d’accès nécessitent les vérifications décrites dans les méthodes correspondantes.

Dans cette rubrique : `39` méthodes.

Des questions ? Envoyez-nous le Request ID et une description : nous vous aiderons à y voir plus clair.[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.