Console et équipes

La console, sur spicyapi.ai/console, est l’endroit où vous gérez votre compte dans un navigateur web : argent, clés API, journal, coéquipiers et réglages. Vos propres programmes n’utilisent jamais la console. Ils appellent l’API avec une clé API.

Vous débutez ? Suivez d’abord Préparer votre compte : ce guide vous fait passer dans l’ordre par l’inscription, l’ajout de fonds et la création d’une clé. Cette page-ci sert de référence pour tout le reste de la console.

S’orienter

En haut de chaque page : votre solde avec un bouton Recharger, Modèles, Documentation, la cloche des notifications et Trouver une page (appuyez sur ⌘K sous macOS ou sur Ctrl + K sous Windows et Linux, puis tapez le nom d’une page de la console).

À gauche, la barre latérale. Tout en haut se trouve le sélecteur de périmètre, qui détermine le compte ou l’équipe que vous consultez (voir Périmètre personnel et équipes). En dessous, les pages sont regroupées :

Sur un téléphone, ouvrez la barre latérale avec le bouton de menu.

Les pages de la console en un coup d’œil

Toutes les adresses commencent par https://spicyapi.ai. Les adresses de la console n’ont pas de préfixe de langue.

Le rôle de chaque page

Vue d’ensemble

La première page affichée après la connexion.

• La liste Premiers pas : Vérifier votre e-mail, Ajouter des fonds, Lancer votre première tâche, plus des liens pour développer avec l’API ou créer sans code. Masquez-la avec Masquer les premiers pas une fois terminé.
• Le Solde disponible, avec le montant en attente pour les tâches encore en cours et ce que vous avez dépensé ces 7 derniers jours.
• Requêtes des 7 derniers jours et Erreurs des 7 derniers jours, avec des liens Voir l’utilisation et Voir les journaux.
• Modèles récemment utilisés et Tâches récentes.
• Un avertissement quand le solde est faible ou épuisé. Avec un solde épuisé, les nouvelles tâches sont refusées jusqu’à ce que vous rechargiez ; les tâches déjà acceptées vont tout de même jusqu’au bout.

Facturation

La facturation comporte trois onglets : Aperçu, Consommation et Factures.

Facturation → Aperçu (/console/billing)

• Ajouter des fonds par carte, en crypto ou, quand c’est proposé, par virement manuel. Les instructions pas à pas, les délais et la marche à suivre quand un paiement n’apparaît pas se trouvent dans Préparer votre compte → Ajouter des fonds.
• Demandes de recharge : chaque recharge avec son état (En attente, Payé, Annulé, Remboursé). Ouvrez une demande manuelle en attente avec Finaliser le paiement pour voir ses instructions de paiement et saisir la référence de votre transaction, ou choisissez Annuler la demande en attente si vous n’avez pas payé.
• Recharge automatique : enregistrez une carte et laissez-nous recharger quand le solde baisse. Les règles exactes, y compris ce qui se passe quand un prélèvement échoue, se trouvent dans Préparer votre compte → Recharge automatique.
• Détail du solde : affiché uniquement si votre compte dispose de crédit promotionnel ou d’un crédit approuvé. Chaque lot de crédit promotionnel y figure avec sa date d’expiration.
• Historique du solde : chaque mouvement d’argent, du plus récent au plus ancien. Filtrez par type et par période, ou choisissez Exporter en CSV. Les lignes typiques sont Recharge, Bonus, Gardé de côté (montant mis de côté quand une tâche est acceptée), Facturé (le prix final d’une tâche réussie), Réserve libérée (la part non utilisée de la réservation) et Reversé (toute la réservation rendue après un échec ou un dépassement de délai). Le fonctionnement des prélèvements est expliqué dans Facturation.

Facturation → Consommation (/console/billing/usage)

Les tâches et les dépenses par jour, sous forme de graphique, sur les 7, 30 ou 90 derniers jours ou sur une période personnalisée de 92 jours au plus (jours UTC). En dessous, Par modèle : tâches, échecs, dépenses et part de chaque modèle, avec Voir les tâches pour afficher ces tâches dans le Journal. Exporter en CSV télécharge les totaux quotidiens affichés. Le point de terminaison de consommation de l’API ne rend compte que de la clé qui l’appelle ; cette page montre tout le périmètre sélectionné dans la barre latérale.

Facturation → Factures (/console/billing/invoices)

Saisissez vos coordonnées de facturation, émettez une facture de paiement pour une recharge payée ou un relevé de consommation pour un mois clôturé, et créez des Relevés de compte mensuels (CSV). Ce qui distingue chaque document, et comment en corriger un, est expliqué dans Préparer votre compte → Factures et reçus.

Clés API

Créez, modifiez et révoquez les clés qu’utilisent vos programmes. La liste affiche pour chaque clé sa valeur masquée, ses dépenses à ce jour, ses plafonds, ses modèles autorisés, ses adresses IP autorisées, son expiration et sa dernière utilisation. Recherchez par nom ou par clé masquée, et filtrez par Active, Expirée ou Révoquée.

• Créer une clé crée une clé dans le périmètre sélectionné dans la barre latérale. La clé complète n’est affichée qu’une seule fois.
• Modifier change le nom, les plafonds de dépense (quotidien, mensuel, cumulé), les modèles autorisés, les adresses IP autorisées et l’expiration. Lors d’une modification, un plafond laissé vide signifie « aucun plafond ».
• Révoquer arrête une clé immédiatement, de façon irréversible. Les tâches déjà acceptées continuent et sont facturées.

Chaque champ est expliqué dans Préparer votre compte → Créer une clé API. Les codes d’erreur produits par chaque restriction figurent dans Authentification.

Dans une équipe : vous ne pouvez créer et gérer les clés de l’équipe qu’avec le rôle Propriétaire, Administrateur ou Développeur. La consommation et les plafonds d’une clé d’équipe comptent pour l’équipe, et ses tâches sont payées par le propriétaire de l’équipe.

Webhooks

Un webhook est un message que SpicyAPI envoie à votre propre serveur quand une tâche se termine, pour que vous n’ayez pas à redemander sans cesse. Vous choisissez l’adresse pour chaque tâche avec callBackUrl. Cette page remplit deux fonctions.

Clé de signature des webhooks. Chaque callback est signé, pour que votre serveur puisse vérifier qu’il vient bien de SpicyAPI. Votre compte possède une seule clé de signature, partagée par toutes ses clés API, et sa valeur n’est affichée qu’une fois, au moment de sa création. Les nouveaux comptes ont déjà une clé que personne n’a vue : la carte peut donc indiquer Configurée alors que vous n’avez rien à copier.

1. Choisissez Générer (si la carte indique Non configurée) ou Renouveler (si elle indique Configurée).
2. Copiez la nouvelle clé dans les réglages de votre serveur, en général sous le nom SPICY_WEBHOOK_SECRET.
3. Choisissez Je l’ai enregistrée.

Livraisons de webhooks. Chaque tentative de callback de votre compte, de la plus récente à la plus ancienne, filtrable par Livré, Nouvel essai et Échec, avec le nombre de tentatives et l’heure du prochain essai. Réessayer renvoie le message signé d’origine ; assurez-vous que votre serveur peut recevoir sans risque deux fois le même message. Une livraison dont le contenu stocké a déjà été effacé par vos réglages de conservation ne peut pas être renvoyée.

Intégrations

Des configurations prêtes à copier-coller pour les outils qui fonctionnent avec SpicyAPI. Choisissez un outil pour voir sa configuration et Ouvrir la doc.

• Bases de la connexion : l’URL de base pour les clients compatibles OpenAI, et un raccourci Créer une clé. Donnez à chaque clé le nom de l’outil qui l’utilise.
• Outils officiels : le SDK TypeScript, la CLI, le serveur MCP et l’Agent Skill.
• Clients compatibles OpenAI : les outils qui permettent de changer l’URL de base, pour les modèles de texte et de vidéo. La génération d’images n’est pas disponible sur les points de terminaison compatibles.
• Agents de code : les éditeurs et agents qui ajoutent le serveur MCP, lequel vous demande de confirmer chaque facturation.

Les extraits utilisent l’emplacement réservé MODEL_ID_FROM_CATALOG : remplacez-le par un identifiant de modèle exact tiré du catalogue en direct (GET /api/v1/models, spicyapi models list ou listModels()). Voir Modèles et points de terminaison.

Journal

Toutes les tâches, de la plus récente à la plus ancienne, échecs compris. Chaque ligne affiche la tâche, le modèle, l’état, la latence et le coût.

• Filtres : état, modèle et période. Le champ de recherche accepte un ID exact de tâche ou de requête : c’est le moyen le plus rapide de retrouver la tâche derrière un signalement d’erreur. La page charge jusqu’à 500 lignes ; resserrez les filtres pour en voir d’autres.
• Exporter en CSV exporte toutes les tâches qui correspondent aux filtres : par défaut les 30 derniers jours, au maximum 92 jours ou 10 000 lignes.
• Ouvrir les détails sur une tâche affiche son état, son coût, ses heures de début et de fin, la clé utilisée, l’identifiant de tâche et l’identifiant de requête, le code d’erreur et Raison de l’échec, les paramètres de la requête, la réponse et les liens de téléchargement (Obtenir un lien ; chaque lien expire, et vous pouvez en créer un nouveau).

L’encadré du coût affiche le montant réservé pendant l’exécution, puis le montant réellement facturé après règlement. Un refus de contenu explicitement indiqué sur la page du modèle peut être facturé même si la tâche a échoué. Consultez le règlement plutôt que de déduire un remboursement de l’état.

Trois actions apparaissent dans les détails de la tâche :

Aucune de ces actions n’annule une tâche en cours : les tâches acceptées ne peuvent pas être annulées. Ce que la suppression conserve et efface est décrit dans Conservation et destruction.

Dans une équipe : chaque membre voit les tâches de l’équipe avec leur état et leur coût. Seuls les rôles Propriétaire, Administrateur et Développeur voient les prompts, les résultats et les liens de téléchargement. Les trois actions ci-dessus ne sont disponibles que pour le compte qui a payé la tâche.

Équipe

Créez des équipes, invitez des personnes, changez les rôles, fixez les plafonds de dépense de l’équipe, quittez ou cédez une équipe. Vous travaillez seul ? Vous n’avez pas besoin d’équipe : vos clés, votre solde et votre consommation fonctionnent déjà par eux-mêmes. Tout ce qui concerne les équipes se trouve dans Équipes, plus bas.

Réglages

Une seule page, organisée en groupes.

Compte

• E-mail, marqué Vérifiée ou Non vérifiée. Changez l’adresse de connexion avec Modifier l’adresse de connexion : nous envoyons un lien de confirmation à la nouvelle adresse (valable 20 minutes) et prévenons l’ancienne. Il vous faut votre mot de passe actuel.
• Nom affiché, Identifiant de compte (à citer quand vous contactez l’assistance) et Inscrit depuis.

Sécurité

• Mot de passe. Le changer déconnecte tous les appareils. Un compte créé avec Google ou GitHub n’a pas de mot de passe tant que vous n’avez pas choisi Envoyer le lien de configuration pour en définir un ; un mot de passe est nécessaire pour clôturer le compte ou transférer une équipe.
• Appareils connectés. Choisissez Déconnecter pour tout appareil que vous ne reconnaissez pas, ou Tout déconnecter (y compris cet appareil) si vous pensez que quelqu’un d’autre a accès au compte. Changez ensuite votre mot de passe sans attendre.
• Authentification à deux facteurs. Choisissez Configurer la 2FA, saisissez votre mot de passe actuel, ajoutez le compte à une application d’authentification et saisissez son code à six chiffres. À partir de là, chaque connexion demande un code. Vous recevez aussi dix codes de récupération à usage unique : conservez-les ailleurs que sur votre téléphone, car sans le téléphone ils sont le seul moyen de revenir dans le compte, et ils ne peuvent plus être affichés. Nouveaux codes de récupération les remplace tous ; Désactiver la 2FA supprime la double authentification. Ces deux actions vous demandent d’abord de confirmer votre identité.
• Activité de sécurité : connexions récentes, nouveaux appareils et changements d’identifiants.

Préférences

• Langue des erreurs de l’API : la langue de msg dans les réponses d’erreur et de l’errorMessage des tâches (dans les vérifications d’état et les webhooks) pour les requêtes faites avec vos clés API. L’anglais est la langue par défaut. L’en-tête Accept-Language d’une requête est prioritaire, et les codes sur lesquels votre code doit s’appuyer (code, errorCode) ne changent jamais. Voir Erreurs.

Facturation et données

• Des raccourcis vers Coordonnées de facturation et relevés (dans Facturation → Factures) et Données et confidentialité (la page Protection des données).

Zone sensible : Clôturer le compte

La clôture déconnecte tous les appareils, révoque définitivement toutes les clés API et supprime les médias générés et le contenu conservé des tâches. Les enregistrements de facturation, d’audit et de rapprochement sont conservés, comme le décrit la politique de confidentialité. Les demandes de recharge abandonnées, que vous n’avez jamais payées, sont annulées pour vous. La clôture n’attend que dans les cas suivants :

• des tâches sont en file d’attente ou en cours, ou des tâches terminées sont encore en cours de règlement (en général en moins d’une minute) ;
• un paiement de recharge est encore en cours de traitement (il disparaît de lui-même dès que le prestataire de paiement le confirme ou le libère, en général en quelques minutes ; contactez le support s’il est toujours là après une heure) ;
• le compte doit de l’argent (crédit approuvé utilisé ou solde négatif), ce que vous réglez en rechargeant ;
• une équipe dont vous êtes propriétaire doit encore être transférée à un autre membre ou vidée de ses autres membres.

La console liste tout ce qui bloque encore. Vous confirmez avec votre mot de passe actuel ou, si vous vous êtes inscrit avec Google ou un autre fournisseur de connexion et n’avez pas de mot de passe, avec un code à 6 chiffres que nous vous envoyons par e-mail (valable 15 minutes).

Notifications

• Alerte de solde faible. Activez-la et choisissez un seuil (5 $, 10 $, 25 $, 50 $ ou 100 $). Quand votre solde disponible passe sous ce seuil, vous recevez une alerte dans la cloche des notifications, plus un e-mail si votre compte a une adresse e-mail. Vous n’êtes alerté de nouveau qu’une fois le solde remonté au niveau du seuil ou au-dessus, puis repassé en dessous. Les soldes sont vérifiés environ toutes les 10 minutes.
• Mises à jour des modèles suivis. Suivez un modèle depuis sa page sur spicyapi.ai ; Gérer ouvre la liste des modèles suivis et les nouveautés produit.
• Canaux. Les alertes dans l’application sont toujours actives. Les e-mails Nouveautés produit et Offres et annonces peuvent être activés ou désactivés. Les avis de sécurité, de facturation et ceux qui sont indispensables au service sont toujours envoyés.

Protection des données

• Conservation : trois durées distinctes pour les Résultats générés, le Texte des prompts et les Fichiers importés. Vous pouvez seulement les rendre plus courtes que les maximums de la plateforme (14 jours pour les résultats, 30 jours pour le texte des prompts, 24 heures pour les fichiers téléversés). Raccourcir une durée peut supprimer le contenu de tâches déjà exécutées lors du prochain nettoyage, qui a lieu dans la minute ; la console compte ce qui sera touché avant que vous confirmiez, et le contenu supprimé ne peut pas être restauré. Téléchargez d’abord tout ce que vous voulez garder.
• Conservation du contenu des tâches : une carte plus ancienne, avec deux réglages. Conserver le contenu des tâches indique, en jours, combien de temps le contenu des tâches est conservé ; réglez cette durée avec les trois durées ci-dessus. Effacer peu après la fin efface le contenu d’une tâche terminée environ une heure après que ses résultats ont été stockés et son webhook livré.
• Où vont vos données : un résumé de ce à quoi la politique de confidentialité nous engage déjà, notamment le fait que vos entrées et vos résultats ne servent pas à entraîner des modèles.
• Télécharger mes données : un fichier JSON avec votre profil, vos rôles d’équipe, le détail de vos clés API (jamais les clés elles-mêmes), les données de tâches conservées et les enregistrements de facturation. Les fichiers médias ne sont pas inclus : téléchargez les résultats séparément.

Les règles complètes, y compris le réglage par requête et ce que la suppression conserve, se trouvent dans Conservation et destruction.

Assistance

Ouvrez une conversation privée que seuls vous et l’assistance SpicyAPI pouvez lire. Choisissez Nouvelle conversation, un objet, un sujet (Compte, Facturation, Intégration API, Tâche ou résultat, Confidentialité, Entreprise ou Autre sujet) et décrivez ce qui s’est passé. Les réponses apparaissent dans la conversation (état En attente de l’assistance, En attente de votre réponse, Résolue ou Close) et dans la cloche des notifications.

Aidez-nous à vous aider vite : indiquez l’identifiant de la tâche, le request_id d’une réponse d’erreur ou l’identifiant de la demande de recharge, et à peu près quand cela s’est produit (UTC). Ne collez jamais de clé API, de mot de passe ni de données de carte. Vous pouvez aussi écrire à support@spicyapi.ai.

Équipes

Périmètre personnel et équipes

Chaque compte a un périmètre Personnel. Personne d’autre n’y a accès, et si vous travaillez seul, c’est tout ce dont vous avez besoin : vos clés personnelles, votre solde et votre consommation fonctionnent sans équipe.

Une équipe permet à des collègues de partager des clés API, de voir le même historique de tâches et de travailler sous des plafonds de dépense communs. Chaque équipe a ses propres membres, ses propres clés et ses propres plafonds.

Le sélecteur de périmètre, en haut de la barre latérale, détermine ce qu’affiche la console :

• Personnel : uniquement votre propre périmètre.
• Le nom d’une équipe : uniquement les clés, les tâches, la consommation et l’activité de cette équipe.
• Tous les périmètres : tout ce à quoi vous avez accès, réuni.
• Nouvelle équipe : un raccourci pour en créer une.

Il détermine aussi où va une nouvelle clé API : une clé créée pendant qu’une équipe est sélectionnée appartient à cette équipe.

Qui paie pour une équipe

Chaque tâche envoyée avec une clé API d’équipe est payée sur le solde du propriétaire de l’équipe. C’est la règle la plus importante des équipes.

• Les membres ne rechargent jamais une équipe et ne voient jamais le solde, les recharges, les données de paiement ni les factures du propriétaire.
• Si vous êtes membre et qu’une clé d’équipe commence à renvoyer 40201, c’est au propriétaire d’ajouter des fonds.
• Vos clés personnelles, votre solde et votre consommation ne sont jamais partagés avec une équipe que vous rejoignez, et quitter une équipe n’y touche pas.
• Un propriétaire, un administrateur ou un développeur peut créer des clés d’équipe qui dépensent le solde du propriétaire. Propriétaires : fixez des plafonds de dépense d’équipe et donnez aux clés leurs propres plafonds.

Créer une équipe

1. Ouvrez Équipe et choisissez Créer une équipe (ou Nouvelle équipe dans le sélecteur de périmètre).
2. Saisissez un nom d’équipe (120 caractères au maximum) et choisissez Créer.

Vous devenez Propriétaire de l’équipe. Un compte peut posséder jusqu’à 10 espaces de travail, et votre périmètre Personnel compte pour l’un d’eux : vous pouvez donc créer jusqu’à neuf équipes. Le nombre d’équipes d’autres personnes que vous pouvez rejoindre n’est pas limité.

Inviter des personnes

Seul un Propriétaire ou un Administrateur peut inviter.

Règles des invitations :

• Une invitation ne peut être acceptée que par un compte dont l’adresse e-mail correspond à l’adresse invitée. Avec une autre adresse, le message est Please sign in with the invited email address to accept this invite.
• Les comptes privés autogérés ne peuvent pas rejoindre d’équipe, car ils n’ont pas d’adresse e-mail.
• Une seule invitation en attente par adresse e-mail et par équipe. Une personne déjà membre ne peut pas être invitée de nouveau.
• Une équipe peut compter jusqu’à 100 membres, propriétaire compris.
• Révoquer annule à tout moment une invitation en attente ; vous pourrez inviter la même personne plus tard.
• Une invitation expirée ne peut pas être acceptée. Envoyez-en une nouvelle.

Rôles et permissions

Les rôles portent ces noms dans la console. L’API et les exports utilisent les noms en minuscules indiqués entre parenthèses.

Par ailleurs :

• Personne ne peut modifier son propre rôle. Le rôle du propriétaire ne change que par un transfert.
• Relancer, détruire ou retirer une tâche n’est possible que pour le compte qui l’a payée, quel que soit le rôle.
• Un membre dont le rôle ne permet pas de lire le contenu voit Votre rôle permet de consulter l’état des tâches et la consommation, mais pas de lire les prompts ni les résultats.
• Personne d’autre que le propriétaire ne voit jamais son solde personnel, ses recharges, ses données de paiement ni ses factures. Activité de l’équipe ne liste que les mouvements d’argent causés par les tâches de l’équipe.

Plafonds de dépense de l’équipe

Chaque équipe (ainsi que votre périmètre Personnel) a un plafond quotidien et un plafond mensuel en dollars américains, sous Équipe → votre équipe → Plafonds de dépense. Les propriétaires, les administrateurs et les gestionnaires du budget peuvent les changer avec Modifier, puis Enregistrer les plafonds.

• Ils couvrent l’ensemble des tâches envoyées avec les clés de ce périmètre.
• L’argent déjà facturé et l’argent en attente pour les tâches encore en cours comptent tous les deux.
• Le plafond quotidien repart à 00:00 UTC ; le plafond mensuel le 1er de chaque mois à 00:00 UTC.
• Sans plafond est la valeur par défaut. Saisissez 0 pour ne fixer aucune limite. Laisser un champ vide conserve sa valeur actuelle.
• Une tâche qui dépasserait un plafond est refusée avec 40202 et le message Workspace daily budget has been reached ou Workspace monthly budget has been reached. Rien n’est créé et rien n’est mis de côté.

Les plafonds de l’équipe s’appliquent en plus des plafonds quotidien, mensuel et cumulé propres à chaque clé, et du solde du propriétaire. Le premier épuisé arrête la tâche. Tous les plafonds de dépense sont décrits dans Facturation.

Changer les rôles et retirer des membres

Ouvrez l’équipe. Sous Membres, choisissez un nouveau rôle pour un membre et confirmez avec Modifier le rôle ; le changement est immédiat. Retirer exclut aussitôt un membre de l’équipe : il perd l’accès à l’équipe, à ses clés et à son activité. Le propriétaire ne peut pas être retiré.

Retirer un membre ne révoque pas les clés qu’il a créées ou utilisées. Les clés d’équipe appartiennent à l’équipe : révoquez donc, dans Clés API, toute clé que cette personne détient encore.

Quitter une équipe

Tout membre autre que le propriétaire peut partir : ouvrez l’équipe, choisissez Quitter l’équipe, puis confirmez. L’accès prend fin immédiatement, et seule une nouvelle invitation peut vous faire revenir.

Rien n’est supprimé. Les clés, les tâches et la consommation de l’équipe restent à l’équipe et restent facturées à son propriétaire. Si vous détenez encore l’une de ses clés, demandez à un administrateur de la révoquer. Votre périmètre personnel n’est pas touché.

Le propriétaire ne peut pas simplement partir : les clés de l’équipe continueraient à dépenser son argent sans que personne puisse les gérer. Transférez d’abord la propriété. Si vous êtes le seul membre, invitez quelqu’un et cédez-lui l’équipe.

Transférer la propriété

Seul le propriétaire peut transférer, et uniquement à une personne déjà membre.

1. Ouvrez l’équipe et allez dans Zone sensible → Transférer la propriété.
2. Choisissez le Nouveau propriétaire et saisissez votre Mot de passe actuel. (Un compte créé avec Google ou GitHub doit d’abord définir un mot de passe dans Réglages.)
3. Vérifiez, puis choisissez Transférer l’équipe.

À partir de ce moment :

• le solde du nouveau propriétaire paie chaque tâche envoyée avec les clés de l’équipe, et toutes les clés de l’équipe passent sur le compte du nouveau propriétaire ;
• vous devenez Administrateur ;
• les tâches acceptées avant le transfert conservent leur facturation d’origine et ne sont pas annulées.

Supprimer une équipe

Une équipe ne peut pas être supprimée. Une équipe inutilisée ne coûte rien et n’apparaît jamais sur une facture. Retirez ses membres et laissez-la inactive, ou renommez-la et réutilisez-la au lieu d’en créer une autre.

Limites des équipes en un coup d’œil