L'API Claude fonctionne en prépaiement et à l'usage : sans solde ni crédit disponible sur le compte, les requêtes échouent. Les utilisateurs de certaines régions rencontrent souvent les mêmes difficultés : moyen de recharge peu pratique, taux de change et frais opaques, facturation difficile à obtenir.

Cet article présente les deux voies de recharge de l'API Claude, les points à vérifier et les questions fréquentes. Les tarifs, taux de change et règles de facturation applicables sont ceux de l'éditeur et du site.

Remarque : Claude et Anthropic sont des marques de leurs détenteurs respectifs. Cet article n'a qu'une vocation d'explication technique.

1. Deux voies de recharge

Voie A : compte Anthropic

Associez un moyen de paiement dans la console Anthropic, achetez des crédits ou activez la recharge automatique. Cette voie convient aux équipes disposant d'un moyen de paiement international et d'un accès stable aux services de l'éditeur.

Points à vérifier :

  • les moyens de paiement acceptés ;
  • l'éventuel renouvellement automatique ;
  • l'adresse de facturation et les informations fiscales ;
  • le téléchargement des factures et reçus.

Voie B : recharge via ZSQH AI Gateway

  1. Ouvrez ZSQH AI Gateway et inscrivez-vous ou connectez-vous.
  2. Accédez à la section « Portefeuille » ou « Recharge ».
  3. Choisissez le montant et le moyen de paiement.
  4. Finalisez le paiement et vérifiez que le solde est crédité.
  5. Appelez les modèles Claude avec la clé API du même compte.

Cette voie convient aux équipes qui paient localement, veulent une facturation unifiée et utilisent plusieurs fournisseurs de modèles.

2. Ce qu'il faut vérifier avant de recharger

Élément À vérifier
Devise Dollar ou monnaie locale, conversion automatique ou non
Taux de change Moment de référence, frais inclus ou non
Crédit Immédiat ou différé, procédure en cas d'échec
Montant minimum Existence d'un seuil de recharge
Facture Possibilité, type et délai d'émission
Remboursement Solde non utilisé remboursable, conditions
Validité Date d'expiration éventuelle du solde

Ne vous limitez pas aux offres « rechargez X, recevez Y » : vérifiez d'abord le crédit réellement utilisable et les règles de remboursement.

3. Configuration après recharge

Une fois le solde crédité, appelez l'API avec votre clé :

export ANTHROPIC_API_KEY="sk-votre-clé"

curl "https://ai.zhongshangqihang.com/v1/messages" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 128,
    "messages": [{"role": "user", "content": "Réponds seulement OK"}]
  }'

Si l'API renvoie insufficient quota, vérifiez d'abord le solde et le plafond de la clé, puis l'activation du modèle.

4. Maîtriser les coûts

  1. Créez une clé distincte par projet avec un plafond.
  2. Utilisez Haiku ou Sonnet pour les tâches simples, Opus pour les tâches complexes.
  3. Évitez d'injecter tout le dépôt dans le contexte.
  4. Résumez les journaux longs avant de les envoyer.
  5. Surveillez les nouvelles tentatives et les erreurs 429.
  6. Consultez chaque semaine les journaux d'usage pour identifier les projets coûteux.
  7. Répartissez les coûts par membre et par projet.

Les prix unitaires applicables sont ceux de la page Tarifs des modèles. Pour la méthode d'estimation, voir Tarifs de l'API Claude.

5. Factures et conformité

Un achat en entreprise exige généralement :

  • un type de facture adapté à la comptabilité locale ;
  • un contrat ou une commande ;
  • une preuve de paiement ;
  • des clauses d'utilisation des données.

Les politiques varient selon le fournisseur : renseignez-vous avant de recharger. Pour un simple test personnel, commencez par un petit montant afin d'éviter un solde inutilisé.

6. Questions fréquentes

Pourquoi l'API indique-t-elle un solde insuffisant après recharge ?

Cela peut venir d'un délai de crédit, d'un plafond de clé, d'un modèle non activé ou d'une requête vers un modèle plus cher. Consultez d'abord le solde et les journaux d'usage dans la console.

Le solde expire-t-il ?

Cela dépend de la politique du fournisseur. Vérifiez la durée de validité et les règles de remboursement au moment de la recharge.

Peut-on obtenir un remboursement ?

Cela dépend des conditions de la plateforme. Les règles peuvent différer pour le solde non utilisé, les crédits offerts lors d'une promotion et les sommes déjà consommées.

La recharge via une passerelle est-elle plus avantageuse que la recharge directe ?

Pas nécessairement. Comparez en intégrant le taux de change, les frais, la facturation, la stabilité de l'accès et le coût d'exploitation.

Une vérification d'identité est-elle requise ?

Cela dépend du canal de paiement et du fournisseur. Un achat en entreprise demande généralement les informations de la société.

7. Rappels de sécurité

  • Ne saisissez jamais votre clé API sur une page non vérifiée.
  • Avant de recharger, vérifiez le nom de domaine et le bénéficiaire du paiement.
  • Conservez le numéro de commande et la preuve de paiement.
  • Méfiez-vous des « recharges à bas prix » qui demandent vos identifiants de compte.
  • Pour un paiement d'entreprise, passez par le circuit contractuel et le compte de la société, afin d'éviter les risques liés à un virement personnel.

Pour aller plus loin

Pour une recharge locale, une facturation unifiée ou l'accès à plusieurs modèles, vous pouvez créer un compte sur ZSQH AI Gateway, recharger un petit montant et valider le fonctionnement, puis créer des clés par projet. Les modèles et tarifs applicables sont ceux de la page Tarifs des modèles.

Lectures associées :