docs
API du tableau de bord

API du tableau de bord

Markdown

Mé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émentAdresseAutorisation
API du tableau de bordhttps://ailoot.ai/api/v1Authorization: Bearer $TOKEN — token de l’espace personnel obtenu après connexion
API des modèleshttps://api.ailoot.ai/v1Clé 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.

Consulter votre profil
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.

Structure d’une réponse paginée
{
  "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.

Liste des clés et clé du compte
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.

Encore des questions ? Envoyez le Request ID et une description : nous vous aiderons à comprendre.Contacter l’assistance