Connecter votre propre clé de modèle
Utilisez une clé provenant d’un fournisseur de modèles ou d’une passerelle. Pour réussir la connexion, le fournisseur, le point de terminaison, l’ID de modèle et les autorisations du compte doivent correspondre.
Rassembler les informations de connexion
Vous avez besoin d’une clé API du service que vous souhaitez appeler, de son URL de base d’API, d’un ID de modèle disponible et d’un protocole ou préréglage compatible. Un compte sur un site grand public de chat ne fournit pas à lui seul un accès à l’API ni des crédits d’API.
Tous les forfaits, y compris Free, prennent en charge le BYOK. La clé de votre fournisseur utilise la facturation et les quotas de ce fournisseur, et non le solde OpenDesign.
Ajouter le fournisseur
- Ouvrez Settings → Models & providers → API providers.
- Choisissez le préréglage correspondant au service qui a émis votre clé. Pour Custom provider, utilisez le protocole indiqué dans la documentation de ce service.
- Collez uniquement le secret dans API Key. N’ajoutez ni Bearer, ni guillemets, ni enveloppe de configuration JSON.
- Vérifiez Base URL. Si l’adresse d’un préréglage est verrouillée, utilisez son option d’URL personnalisée avant de saisir un autre point de terminaison.
- Choisissez un modèle dans la liste disponible ou saisissez l’ID exact du modèle d’API sous Custom. Le chargement des modèles dépend du service et du compte.
- Exécutez Test. Lisez sa réponse : un test réussi valide cette petite requête, mais pas tous les outils, modèles multimédias ou requêtes futures.
- Attendez la confirmation de l’enregistrement. Rouvrez les paramètres pour vérifier le fournisseur, l’adresse et le modèle, puis revenez au projet et sélectionnez cette connexion avant d’envoyer une petite tâche.
Gardez la clé confidentielle. Le champ peut être révélé avec Show pour une vérification locale ; masquez la clé avant de partager une capture d’écran.
Exemple : DeepSeek
Créez une clé sur DeepSeek Platform. Utilisez https://api.deepseek.com comme URL de base et choisissez un modèle que votre compte peut appeler. Utilisez un ID de la liste actuelle des modèles du fournisseur, par exemple deepseek-flash ; la capture d’écran du client installé contient encore un ancien alias de préréglage. Si nécessaire, saisissez l’ID actuel comme modèle personnalisé. Dans la version 0.25.0 installée, le raccourci Get key peut ouvrir la mauvaise page de fournisseur. Utilisez la console du fournisseur au lieu de créer une clé OpenAI sans rapport.
| Champ | Exemple DeepSeek direct |
|---|---|
| Fournisseur / protocole | Préréglage DeepSeek, ou préréglage personnalisé compatible avec le protocole OpenAI |
| API Key | Une clé émise par votre compte DeepSeek Platform |
| Base URL | https://api.deepseek.com |
| ID de modèle | deepseek-flash, s’il est activé pour votre compte |
Copiez l’ID exact depuis la documentation actuelle de l’API DeepSeek, plutôt que le nom d’affichage figurant dans une ancienne capture d’écran. Pour cet exemple utilisant le protocole OpenAI, n’utilisez pas le point de terminaison /anthropic distinct.
Exemple : OpenRouter
Créez une clé dans les paramètres de clés d’OpenRouter. Utilisez https://openrouter.ai/api/v1. Copiez un ID de modèle depuis la liste des modèles disponibles d’OpenRouter, y compris son préfixe de fournisseur. Ne placez pas une clé Anthropic ou OpenAI directe dans le préréglage OpenRouter. La clé doit appartenir à la passerelle qui reçoit la requête.
- Choisissez OpenRouter dans API providers et collez une clé émise par OpenRouter.
- Utilisez https://openrouter.ai/api/v1 comme Base URL.
- Copiez l’ID exact du modèle depuis le répertoire des modèles OpenRouter, y compris le préfixe du fournisseur.
- Testez la connexion, attendez l’enregistrement et sélectionnez-la dans le projet avant d’exécuter une requête.
Vérifier un autre fournisseur
| Élément | Points à vérifier |
|---|---|
| Protocole | Le préréglage doit correspondre au protocole d’API indiqué dans la documentation. |
| Base URL | Utilisez la racine d’API attendue par le préréglage, sans chemin de tableau de bord ni segment de version en double. |
| Modèle | Utilisez l’ID du modèle d’API, et non son nom commercial. |
| Autorisation | Confirmez l’accès au modèle, la disponibilité régionale, le quota et la facturation sur le compte du fournisseur. |
Une clé ne constitue pas l’ensemble de l’environnement d’exécution
Les tâches BYOK nécessitent toujours l’environnement d’exécution pris en charge qui effectue les opérations de l’agent sur les fichiers et les outils. Si l’application indique que l’environnement d’exécution est indisponible, suivez ses instructions d’installation ou de nouvelle analyse. Le remplacement de la clé n’installera aucun exécutable.
Comprendre la facturation
Les requêtes BYOK sont facturées par le fournisseur ou la passerelle dont vous avez saisi la clé. Un abonnement OpenDesign et le solde d’un fournisseur externe sont distincts. Consultez la facturation et le dépannage de la connexion si une clé valide ne permet toujours pas d’exécuter une tâche.
Interpréter le résultat du test et résoudre les problèmes
| Résultat | Action suivante |
|---|---|
| 401 / clé non valide | Vérifiez le service émetteur et collez la clé complète sans mise en forme supplémentaire. Remplacez une clé révoquée depuis le service qui l’a émise. |
| 403 / accès refusé | Vérifiez auprès du fournisseur les autorisations du modèle, la région et l’accès du compte. Un secret valide ne suffit pas à accorder l’accès au modèle. |
| 404 / modèle introuvable | Vérifiez la racine de l’API et l’ID exact du modèle. Supprimez les chemins de tableau de bord et les segments /v1 en double. |
| 429 / quota ou limite de débit | Lisez l’erreur du fournisseur pour distinguer un solde épuisé d’une limite de débit temporaire. Vérifiez la console du compte avant de réessayer. |
| Délai d’attente dépassé / erreur réseau | Vérifiez si ce point de terminaison est accessible depuis l’environnement du client. Réessayez avec une petite requête après avoir résolu le problème réseau. |
Après un test réussi, envoyez une petite requête dans le projet existant, puis examinez sa réponse et tout fichier créé. Si le test réussit mais que les opérations sur les fichiers échouent, vérifiez l’environnement d’exécution décrit dans la section correspondante ; ne remplacez pas de manière répétée une clé qui fonctionne.