Passer au contenu principal

Clés API

Toutes les requêtes API nécessitent une authentification à l’aide d’une clé API. Incluez votre clé dans l’en-tête Authorization :
Authorization: Bearer sk-your-api-key

Obtenir votre clé API

  1. Connectez-vous à votre Tableau de bord LemonData
  2. Accédez à la section API Keys
  3. Cliquez sur Create New Key
  4. Donnez un nom descriptif à votre clé
  5. Copiez la clé immédiatement - elle ne s’affiche qu’une seule fois
Meilleures pratiques de sécurité :
  • N’exposez jamais les clés API dans le code côté client
  • Ne validez pas les clés dans le contrôle de version
  • Utilisez des variables d’environnement pour stocker les clés
  • Effectuez une rotation périodique des clés
  • Supprimez les clés inutilisées

Utilisation des clés API

curl https://api.lemondata.cc/v1/chat/completions \
  -H "Authorization: Bearer $LEMONDATA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "Hello!"}]}'

Fonctionnalités des clés API

Limites d’utilisation

Vous pouvez définir une limite d’utilisation sur chaque clé API pour contrôler les dépenses :
ParamètreDescription
No LimitLa clé utilise le solde de votre compte sans restrictions
Fixed LimitLa clé cesse de fonctionner après avoir atteint le montant spécifié

Préfixe de clé

Toutes les clés API LemonData commencent par le préfixe sk-. Le format de la clé est :
sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Compatibilité avec l’API Anthropic

Pour le point de terminaison /v1/messages, vous pouvez utiliser l’en-tête x-api-key (compatible avec le SDK Anthropic) :
curl https://api.lemondata.cc/v1/messages \
  -H "x-api-key: sk-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'
L’en-tête x-api-key est uniquement pris en charge sur les points de terminaison /v1/messages et /v1/messages/count_tokens. Les autres points de terminaison nécessitent l’en-tête Authorization: Bearer.

Réponses d’erreur

Code d’étatTypeCodeDescription
401invalid_request_errorinvalid_api_keyClé API manquante ou invalide
401invalid_request_errorexpired_api_keyLa clé API a été révoquée
402insufficient_quotainsufficient_quotaLe solde du compte est insuffisant
402insufficient_quotaquota_exceededLimite d’utilisation de la clé API atteinte
Exemple de réponse d’erreur :
{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_api_key",
    "code": "invalid_api_key"
  }
}