API du tableau de bord
MarkdownMéthodes de l’espace personnel : connexion, profil, clés et historique des dépenses.
Guide complet
Adresses et authentification
- Espace personnel : https://ailoot.ai (connexion par identifiants, token de l’espace personnel)
- API des modèles : https://api.ailoot.ai (clé sk-…)
| Élément | Adresse | Autorisation |
|---|---|---|
| API du tableau de bord | https://ailoot.ai/api/v1 | Authorization: Bearer $TOKEN — token de l’espace personnel obtenu après connexion |
| API des modèles | https://api.ailoot.ai/v1 | Clé sk-… depuis la rubrique « Clés API » ; voir Clés et URL de l’API |
Clé sk-… ne remplace pas le token de l’espace personnel, et ce dernier ne donne pas accès à l’API des modèles. Le chemin complet est précisé pour chaque méthode.
curl --fail-with-body "https://ailoot.ai/api/v1/user/profile" \
-H "Authorization: Bearer $TOKEN"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.
{
"code": 0,
"message": "success",
"data": {
"items": [],
"total": 0,
"page": 1,
"page_size": 20,
"pages": 1
}
}La validité du token de l’espace personnel 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.
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 « Offres » de l’espace personnel : comment recharger.
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.
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.
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"Dépenses et sécurité
L’historique et le dashboard 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.