Préparer votre compte

Créer votre compte et vérifier votre adresse e-mail

Ouvrez spicyapi.ai/register. Il existe trois façons de s’inscrire :

Cochez la case d’acceptation des conditions d’utilisation et de la politique de confidentialité, puis choisissez Créer le compte.

Ce que vous devez voir : pour un compte e-mail, une page intitulée Consultez votre boîte mail. Ouvrez l’e-mail et cliquez sur le lien. La page E-mail vérifié le confirme, et Aller à la console vous fait entrer.

Ce qui vient de se passer : votre compte existe, mais il ne peut appeler l’API qu’une fois l’adresse e-mail vérifiée. D’ici là, la console affiche le bandeau E-mail non vérifié — les appels d’API sont bloqués.

• Le lien ne fonctionne qu’une fois et expire au bout de 24 heures. S’il a expiré, ouvrez-le quand même et utilisez Renvoyer un lien de vérification, ou choisissez Vérifier sur le bandeau de la console.
• Rien reçu au bout de quelques minutes ? Regardez dans vos courriers indésirables, puis utilisez Renvoyer.

Ajouter des fonds

Ouvrez Facturation dans la console : spicyapi.ai/console/billing. Dans Ajouter des fonds :

1. Choisissez un montant. Prenez l’un des montants proposés (par exemple $10, $25, $50 ou $100), ou Autre montant pour saisir le vôtre. La console indique le montant minimal et le montant maximal que vous pouvez ajouter en un seul paiement. Les paiements en ligne acceptent au maximum deux décimales.
2. Repérez un éventuel bonus. Certains montants s’accompagnent d’un bonus promotionnel, affiché sous la forme +$… offerts avant le paiement. Le bonus est ajouté comme une écriture distincte, à côté du montant que vous avez payé.
3. Choisissez un moyen de paiement et suivez l’onglet correspondant ci-dessous.

Autres messages que vous pourriez voir :

• Recharge indisponible ou Impossible de créer une demande pour le moment : les recharges sont temporairement fermées, ou vous avez trop de demandes en attente. Finalisez ou annulez les anciennes dans Demandes de recharge, ou réessayez plus tard.
• La connexion a été coupée : le résultat est incertain : consultez Demandes de recharge avant de réessayer, pour ne pas payer deux fois.

Facultatif : activer la recharge automatique

La recharge automatique débite pour vous une carte enregistrée quand votre solde devient bas, pour que les longs travaux ne s’arrêtent pas à mi-chemin avec 40201. Elle ne fonctionne qu’avec une carte.

1. Dans Facturation, repérez Recharge automatique et choisissez Enregistrer le moyen de paiement en toute sécurité.
2. Saisissez votre carte sur la page sécurisée qui s’ouvre. Les informations de votre carte restent chez le prestataire de paiement.
3. De retour dans Facturation, vous voyez Vérification de votre moyen de paiement, puis Moyen de paiement enregistré. Si vous voyez Cette carte ne peut pas être utilisée ici, rien n’a été enregistré ; essayez une autre carte.
4. Remplissez trois champs :
   • Recharger sous : le solde qui déclenche un prélèvement.
   • Montant par recharge : ce que chaque prélèvement ajoute. Il doit rester dans la même fourchette qu’une recharge normale.
   • Plafond mensuel : le montant maximal que la recharge automatique peut prélever sur un mois calendaire. Il ne peut pas être inférieur au montant par recharge.
5. Cochez l’autorisation et choisissez Activer la recharge automatique.

Ce que vous devez voir : La recharge automatique est active avec ces limites. La carte affiche la règle, par exemple « Recharge de $50 dès que votre solde passe sous $10 », ainsi que Utilisé ce mois-ci.

Les règles, précisément :

• Nous vérifions votre solde toutes les 30 secondes à 2 minutes environ. Quand votre solde disponible est inférieur ou égal au seuil, nous prélevons le montant défini sur la carte enregistrée.
• Chaque prélèvement est une demande de recharge ordinaire, marquée Recharge auto. Il reçoit le même bonus qu’une recharge manuelle du même montant, et vous pouvez émettre une facture pour lui.
• Le plafond mensuel se compte en mois calendaires UTC. Une fois qu’il est épuisé, la recharge automatique attend le 1er du mois suivant. Les prélèvements échoués ne comptent pas dans le plafond.
• Si un prélèvement échoue, nous réessayons au bout d’1 heure, puis au bout de 6 heures. Si la troisième tentative consécutive échoue aussi, la recharge automatique se désactive d’elle-même. Si la banque refuse catégoriquement la carte (par exemple une carte volée ou clôturée), elle se désactive immédiatement. Un prélèvement réussi remet le compteur à zéro.
• Après une désactivation automatique, réglez le problème de la carte (ou enregistrez-en une nouvelle), puis réactivez la recharge automatique.
• Désactiver la recharge automatique arrête les prélèvements futurs à tout moment. Cela ne modifie jamais votre solde ni les recharges déjà effectuées.

Créer une clé API

Ouvrez Clés API : spicyapi.ai/console/keys, puis choisissez Créer une clé (ou Créer votre première clé).

Dans la fenêtre Créer une clé API, seul le nom est obligatoire. Tout ce qui se trouve sous Avancé peut être modifié plus tard.

Nom. Nommez la clé d’après ce qui va l’utiliser, par exemple production backend ou my laptop. Vous devrez la reconnaître le jour où vous la révoquerez. 120 caractères au maximum.

Plafonds de dépense (sous Avancé, en dollars américains). Quand un plafond est atteint, cette clé refuse les nouvelles tâches avec 40202 jusqu’au début de la période suivante. Vos autres clés continuent de fonctionner. L’argent mis de côté pour des tâches encore en cours compte dans chaque plafond.

Saisissez 0 dans n’importe quel plafond pour n’imposer aucune limite ; un champ vide revient au même.

Accès.

• Modèles autorisés. Laissez Tous les modèles (sans restriction) et la clé peut appeler tous les modèles, y compris ceux ajoutés plus tard. Choisissez des modèles précis, et la clé refuse tout autre modèle avec 40301.
• Adresses IP autorisées. Toutes les adresses accepte les appels venant de n’importe où. Seulement celles-ci n’accepte que les appels provenant des adresses que vous listez : adresses IPv4, IPv6 ou plages CIDR comme 203.0.113.10, 198.51.100.0/24, séparées par des virgules, 64 entrées au maximum. Indiquez l’adresse publique depuis laquelle votre serveur appelle, et non une adresse interne au réseau de votre bureau ou de votre domicile. Les appels venant de toute autre adresse sont refusés avec 40302. Pour un ordinateur portable, dont l’adresse change, laissez Toutes les adresses.
• Expiration. Choisissez 7, 30 ou 90 jours, 1 an, Jamais ou une date précise. La clé cesse de fonctionner à la fin de ce jour, en UTC, et reçoit dès lors le même 401 qu’une clé révoquée.

Choisissez Créer.

Ce que vous devez voir : une fenêtre Clé créée qui affiche la clé complète, commençant par sk-spicy-. Copiez-la avec Copier la clé, ou choisissez Enregistrer dans un fichier. Cochez J’ai mis cette clé en lieu sûr, puis Terminé.

Ce qui vient de se passer : c’est la seule fois où la clé complète est affichée. Nous n’en conservons qu’une empreinte à sens unique : personne, pas même notre équipe d’assistance, ne peut vous la montrer à nouveau. Si vous la perdez, révoquez-la et créez-en une nouvelle.

Plus tard, sur la même page :

• Modifier change le nom, les plafonds, les modèles autorisés, les adresses IP autorisées et l’expiration. Les changements prennent effet immédiatement.
• Révoquer arrête la clé immédiatement et ne peut pas être annulé. Les tâches déjà acceptées continuent de s’exécuter et restent facturées.
• Vous pouvez avoir jusqu’à 50 clés actives dans un même périmètre. Utilisez une clé par application ou par environnement, pour pouvoir en révoquer une sans arrêter les autres.

Placer la clé dans SPICY_API_KEY

Une variable d’environnement est une valeur nommée que votre terminal transmet aux programmes qu’il lance. Le SDK, la CLI et le serveur MCP officiels, ainsi que tous les exemples de cette documentation, lisent votre clé dans une variable appelée SPICY_API_KEY. Ainsi, la clé n’a jamais besoin d’être tapée dans une commande ni enregistrée dans un projet.

Ouvrez d’abord un terminal : sur macOS, appuyez sur Cmd + Espace, tapez Terminal et appuyez sur Entrée. Sur Windows, ouvrez le menu Démarrer, tapez PowerShell et ouvrez Windows PowerShell.

export SPICY_API_KEY="sk-spicy-paste-your-key-here"

nano ~/.zshrc

echo "${SPICY_API_KEY:0:9}"

Sur un serveur, définissez SPICY_API_KEY dans les réglages de secrets ou de variables d’environnement de votre hébergeur, plutôt que dans un fichier de votre projet.

Faire un appel de test gratuit

Cet appel demande votre solde. Il ne coûte rien, ne crée rien et prouve trois choses à la fois : la clé est bien définie, la clé est valide, et votre compte a le droit d’appeler l’API.

curl https://api.spicyapi.ai/api/v1/chat/credit \
  -H "Authorization: Bearer $SPICY_API_KEY"

Résultat attendu : une réponse de ce type (abrégée) :

{
  "code": 200,
  "msg": "success",
  "data": {
    "available": "25",
    "held": "0",
    "total": "25"
  },
  "request_id": "req_01k..."
}

Ce que cela signifie : "code": 200 indique un succès. Les montants sont des dollars américains écrits sous forme de texte. available est ce que vous pouvez dépenser pour de nouvelles générations, held est mis de côté pour des générations encore en cours, et total est la somme des deux. La vraie réponse contient aussi un objet funding qui distingue les fonds payés d’éventuelles dotations promotionnelles ; vous pouvez l’ignorer pour l’instant.

Si vous obtenez autre chose :

Vous préférez ne pas utiliser curl ? La CLI fait la même chose avec spicyapi balance.