API du tableau de bord
MarkdownMéthodes du tableau de bord : connexion, profil, clés et historique des dépenses.
Guide complet
Adresses et authentification
- Tableau de bord : https://ailoot.ai (connexion par identifiants, jeton du tableau de bord)
- 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 — jeton du tableau de bord obtenu après connexion |
| API des modèles | https://api.ailoot.ai/v1 | Clé sk-… depuis la section « Clés API »; voir Clés et adresse de l’API |
Clé sk-… ne remplace pas le jeton du tableau de bord, 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 jeton du tableau de bord 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 de requête présentent les noms et les types des champs. PLACEHOLDER et TOKEN sont des marqueurs; aucune donnée réelle n’est fournie ici.
- L’ajout de fonds au solde se fait dans la section « Tarifs » du tableau de bord : comment ajouter des fonds.
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 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 confirmations décrites dans les méthodes correspondantes.
Dans cette rubrique : 39 méthodes.