API de l’espace client

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

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.

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

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 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.

• 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.
• La recharge du solde se fait dans la rubrique « Tarifs » de l’espace client : comment recharger.

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.

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"

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 par date, modèle, clé et 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 (passkey) nécessitent les confirmations décrites dans les méthodes correspondantes.

Dans cette rubrique : 39 méthodes.