Clés de fournisseurs d'IA

Le principe « apportez votre propre clé » (BYOK) permet aux requêtes d'IA prises en charge d'utiliser votre compte auprès du fournisseur d'IA. Vous n'avez pas besoin de clé : la plateforme fournit les modèles par défaut. L'enregistrement d'une clé nécessite le plan Scale. Les clés déjà enregistrées continuent de fonctionner sur Launch et Operate. Vous payez toujours le plan Make Agent Fast ainsi que des frais de plateforme forfaitaires par action ; le fournisseur facture directement l'utilisation de ses modèles à votre compte.

Fournisseurs pris en charge#

De nouvelles clés ne peuvent être ajoutées que pour deux fournisseurs, l'un pour le texte et l'autre pour la voix :

Clés héritées#

Les clés directes des fournisseurs enregistrées avant le passage à OpenRouter et Speko apparaissent sous Clés héritées. Elles continuent de fonctionner jusqu'à ce que vous les révoquiez, et vous pouvez toujours les révoquer, mais vous ne pouvez plus en ajouter ni en remplacer :

La disponibilité des fournisseurs dépend également des fournisseurs de texte, de voix et de temps réel configurés sur la plateforme. L'enregistrement d'une clé valide n'oblige pas chaque fonctionnalité à utiliser ce fournisseur.

Ajouter une clé de fournisseur#

1. Créez une clé dans la console OpenRouter ou Speko et activez la facturation du fournisseur ou une limite de dépenses si nécessaire.
2. Ouvrez Tableau de bord → Paramètres → Clés de fournisseurs d'IA. Seul le propriétaire de la facturation d'un espace de travail Scale peut enregistrer une clé.
3. Collez la clé dans la carte OpenRouter ou Speko.
4. Sélectionnez Tester et enregistrer.
5. Attendez le résultat de la validation, puis testez la fonctionnalité qui utilise le fournisseur.

Make Agent Fast effectue une requête de validation en direct avant d'enregistrer une clé ; aucun jeton de modèle ni crédit de la plateforme n'est consommé. La clé ne doit contenir ni espaces ni sauts de ligne et doit comporter entre 16 et 512 caractères. Les clés OpenRouter doivent commencer par sk-or- ; les clés Speko doivent commencer par sk_speko_ ou sk_live_. La validation en direct fait foi.

L'enregistrement d'une autre clé fonctionnelle pour le même fournisseur remplace la valeur précédemment stockée. Une clé qui échoue à la validation n'est pas enregistrée ; la clé déjà en place continue donc de fonctionner. Le tableau de bord ne conserve que des données d'identification sûres, telles que les quatre derniers caractères, la date de validation et l'état.

Fonctionnement de la sélection du fournisseur de texte#

Pour la génération de texte, une clé OpenRouter active est prioritaire. À défaut, Make Agent Fast recherche une clé héritée active correspondant au fournisseur de texte configuré sur la plateforme, puis les autres clés de texte héritées (Anthropic, OpenAI, Gemini, xAI, DeepSeek) dans cet ordre. Si aucune clé BYOK adaptée n'existe, il utilise le fournisseur de la plateforme lorsque le plan et le déploiement le permettent.

Les clés de voix sont propres à chaque fournisseur. Une clé Speko est utilisée lorsque la voix passe par Speko. Une clé Deepgram héritée n'est utilisée que lorsque le fournisseur de reconnaissance vocale actif est Deepgram ; une clé ElevenLabs héritée n'est utilisée que lorsque la synthèse vocale est configurée sur ElevenLabs.

Les clés BYOK ne remplacent pas pour l'instant les identifiants d'embeddings de connaissances de la plateforme. L'ingestion et la récupération des connaissances continuent d'utiliser le fournisseur d'embeddings configuré pour le déploiement.

Facturation et crédits#

• Le fournisseur externe facture la consommation de jetons d'IA au compte qui a émis la clé.
• Make Agent Fast facture toujours l'abonnement ainsi que des frais de plateforme forfaitaires pour chaque action exécutée avec votre clé : 1 crédit par réponse de chat, au lieu de la facturation basée sur les jetons. Ces frais couvrent la récupération, l'orchestration et l'hébergement autour de l'appel, et ne représentent pas un pourcentage de votre facture de jetons.
• Les frais s'appliquent à chaque appel au fournisseur. Les étapes vocales financées par la plateforme (par exemple, la transcription lorsque vous n'avez qu'une clé de texte) sont facturées au tarif normal, et les appels en direct utilisent toujours le tarif de la plateforme.
• L'épuisement du quota du fournisseur peut faire échouer une requête même s'il reste des crédits Make Agent Fast.

Consultez à la fois Utilisation et crédits dans Make Agent Fast et le tableau de bord d'utilisation du fournisseur.

États des clés et gestion des échecs#

Si une requête échoue parce qu'un fournisseur rejette l'identifiant ou le quota, Make Agent Fast peut marquer la clé stockée comme invalide. Corriger la clé chez le fournisseur ne révèle ni ne réécrit le secret stocké ; pour une clé OpenRouter ou Speko, utilisez Tester la connexion pour la revérifier, ou enregistrez à nouveau la clé fonctionnelle. Une clé héritée devenue invalide ne peut pas être remplacée par une autre clé héritée : migrez plutôt ce fournisseur vers OpenRouter ou Speko.

Renouveler une clé de fournisseur#

1. Créez une nouvelle clé chez le fournisseur sans supprimer l'ancienne.
2. Enregistrez la nouvelle clé dans Make Agent Fast et vérifiez qu'elle devient active.
3. Testez le chat texte ou les messages vocaux, selon ce qui utilise ce fournisseur.
4. Révoquez l'ancienne clé dans la console du fournisseur.
5. Consultez les journaux du fournisseur pour détecter toute utilisation inattendue de l'ancienne clé.

Si une clé est exposée dans un système de gestion de versions ou dans du code navigateur, révoquez-la immédiatement chez le fournisseur. La supprimer uniquement de Make Agent Fast n'empêche pas une autre personne qui la détient de l'utiliser directement auprès du fournisseur.