API Claude : créer une clé et tester sa première requête

1. Créer sa clé API BetterToken

1. Connectez-vous à BetterToken Workspace.
2. Créez une nouvelle clé API pour le groupe de clés compatible avec Claude indiqué dans la documentation.
3. Copiez la clé une seule fois et conservez-la dans un gestionnaire de secrets ou un fichier d’environnement local exclu de Git.
4. Consultez la documentation actuelle de l’API et la page des tarifs pour confirmer le Model ID en vigueur et sa disponibilité.

Ne collez pas la clé dans le code source, un prompt, une capture d’écran, un message au support ou un dépôt public. Les utilisateurs de BetterToken travaillent avec leurs propres comptes et clés ; le service n’émet pas de clé Anthropic Console et ne vend pas l’accès à un compte Claude.ai partagé.

2. Utiliser l’endpoint compatible avec Anthropic

Pour le SDK Anthropic ou Claude Code, la Base URL de BetterToken est :

https://bettertoken.ai/

N’ajoutez pas /v1 à cette Base URL. Pour une requête HTTP Messages directe, le chemin complet de la ressource est différent :

POST https://www.bettertoken.ai/v1/messages

Cette distinction est importante : les SDK ajoutent le chemin de la ressource, tandis qu’une commande curl directe a besoin de l’URL complète. Les outils compatibles avec OpenAI utilisent une autre Base URL et doivent suivre leur propre guide de configuration.

3. Envoyer la première requête

Placez la clé BetterToken dans une variable d’environnement locale. Le nom de la variable suit la convention du SDK Anthropic, mais sa valeur reste votre clé API BetterToken.

export ANTHROPIC_API_KEY="your_api_key"
export ANTHROPIC_BASE_URL="https://bettertoken.ai"
export CLAUDE_MODEL_ID="YOUR_MODEL_ID"

curl --fail-with-body "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d "{
    \"model\": \"$CLAUDE_MODEL_ID\",
    \"max_tokens\": 64,
    \"messages\": [{\"role\": \"user\", \"content\": \"Return only the word pong.\"}]
  }"

Remplacez les deux espaces réservés uniquement dans votre shell local. Utilisez le Model ID exact et actuel indiqué dans les Docs BetterToken ou sur la page des tarifs ; le nom et la disponibilité des modèles peuvent changer.

4. Vérifier la réponse et l’enregistrement d’utilisation

Une requête réussie renvoie HTTP 200 et un objet message JSON. Vérifiez que :

• type vaut message ;
• content contient la réponse du modèle ;
• usage contient le nombre de tokens d’entrée et de sortie.

La référence officielle Anthropic Messages définit la structure du protocole. Elle ne transforme pas une clé émise par BetterToken en clé Anthropic ; elle documente uniquement le format compatible des requêtes et réponses.

Ouvrez ensuite BetterToken Workspace et faites correspondre la requête à l’aide de son heure. Confirmez le modèle, le statut, les tokens d’entrée, de sortie et de cache le cas échéant, ainsi que le coût associé. Workspace conserve les métadonnées d’utilisation et les relevés de facturation ; ne supposez pas qu’il stocke le prompt ou la réponse dans leur intégralité.

5. Résoudre les erreurs courantes de la première requête

• 404 ou chemin incorrect : une requête HTTP directe utilise /v1/messages ; /messages seul est incomplet.
• 400 : vérifiez anthropic-version, content-type, le Model ID, max_tokens et le tableau messages.
• 401 ou 403 : vérifiez la clé BetterToken, le groupe de clés, la Base URL et les espaces ajoutés par erreur. N’envoyez pas la clé au support.
• 429 : lisez le corps de la réponse, respectez le délai indiqué et vérifiez les requêtes simultanées ainsi que les limites actuelles avant de réessayer.
• Aucun enregistrement dans Workspace : vérifiez que la requête a utilisé la Base URL BetterToken et non un autre fournisseur resté dans votre environnement.

Si des valeurs d’un autre fournisseur restent dans le shell, effacez-les avant de recommencer :

unset ANTHROPIC_API_KEY
unset ANTHROPIC_BASE_URL
unset CLAUDE_MODEL_ID

Redéfinissez ensuite les trois valeurs à partir des informations de configuration BetterToken actuelles et envoyez une seule requête, pas une boucle de tentatives.

Étape suivante

Une fois la requête minimale réussie, placez la clé dans le magasin de secrets de votre application, définissez un timeout fini et ajoutez des tentatives limitées uniquement pour les erreurs temporaires. Consultez les Docs BetterToken actuelles, puis gardez Workspace ouvert pendant le test de votre première intégration réelle.