Connecter un fournisseur
AI Studio fonctionne avec votre propre clé de fournisseur, connectée depuis Settings, AI Settings, sous l'onglet Provider & Model. Avant de pouvoir discuter ou générer, connectez au moins un fournisseur. Voir Utilisez votre propre clé IA pour l'idée derrière ce principe.
Aperçu rapide
- Ouvrez Settings, AI Settings, et choisissez un onglet de fournisseur.
- Collez votre clé API.
- Choisissez un modèle dans la liste de ce fournisseur.
- Définissez un effort de raisonnement, et éventuellement une invite système, une température et un nombre maximal de jetons.
- Testez la connexion, puis activez le fournisseur pour le chat.
Le déroulé de configuration
Pour chaque fournisseur, les étapes se résument aux trois mêmes champs, plus des réglages avancés facultatifs.
| Étape | Détail |
|---|---|
| Clé API | Un champ masqué comme un mot de passe. Une fois enregistrée, elle n'apparaît plus que sous forme d'un court indice, jamais la valeur complète |
| Modèle | Une liste déroulante des modèles disponibles de ce fournisseur |
| Effort de raisonnement | Un ensemble de niveaux propre au fournisseur, affiché uniquement pour les fournisseurs compatibles chat |
| Test | Envoie une petite requête pour confirmer que la clé fonctionne avant que vous ne comptiez dessus |
| Use for chat | Un interrupteur qui en fait le fournisseur actif pour le chat |
Les options d'effort de raisonnement varient selon le fournisseur, par exemple Default, Low, Medium, High, et parfois Extra High ou Max chez les fournisseurs qui prennent en charge un raisonnement plus poussé ; un fournisseur dépourvu de cette capacité saute complètement la commande. La valeur s'applique automatiquement à chaque requête de chat de ce fournisseur, il n'y a pas de réglage par message dans le composeur.
L'écran des paramètres en un coup d'œil
L'onglet Provider & Model présente sur la gauche une liste de tous les fournisseurs. Une icône de bouclier signale chaque fournisseur qui a déjà une clé enregistrée, et celui qui alimente actuellement le chat porte l'étiquette Active. Un bandeau récapitulatif en haut vous indique en permanence quel fournisseur et quel modèle le chat utilise en ce moment, et si une clé est connectée, vous pouvez ainsi confirmer votre configuration sans ouvrir de panneau.
Cliquez sur un fournisseur dans cette liste pour ouvrir son panneau à droite, disposé en trois étapes numérotées :
- API Key, un champ masqué. Une fois enregistrée, il se réduit à un bouton Change et à une commande de suppression (corbeille), et n'affiche plus jamais la clé complète.
- Model, une liste déroulante des modèles de ce fournisseur, avec le choix par défaut sensé marqué recommended.
- Try it, le bouton Test connection.
Si le fournisseur prend en charge un raisonnement réglable, une petite liste déroulante Reasoning intégrée se place entre l'étape 2 et l'étape 3. Sous les trois étapes, un accordéon Advanced (optional) regroupe les réglages plus fins. Pour activer un fournisseur pour le chat, on utilise l'interrupteur Use for chat : vous ne pouvez pas le désactiver directement tant que ce fournisseur est le fournisseur actif ; à la place, vous activez un autre fournisseur, ce qui lui transmet automatiquement l'étiquette Active.
Options avancées
Une section facultative et repliée ajoute un contrôle plus fin.
| Réglage | Plage | Notes |
|---|---|---|
| Invite système | Texte libre | Instructions personnalisées superposées à chaque réponse |
| Température | 0 à 1,5 | Étiquetée Precise, Balanced ou Creative à mesure que vous déplacez le curseur |
| Nombre max de jetons | 256 à 16384 | 2048 par défaut. Plafonne la longueur d'une seule réponse |
Chaque champ avancé s'enregistre de lui-même dès que vous cliquez ailleurs (à la perte de focus), avec un petit message de confirmation, il n'y a donc pas de bouton Save distinct pour ces trois-là. Une fois connectée, votre clé s'affiche masquée, et vous pouvez la modifier ou la supprimer à tout moment. Vous pouvez connecter autant de fournisseurs que vous voulez en même temps, chacun conservant sa propre clé, son modèle et son effort de raisonnement de façon indépendante, il n'y a donc rien à reconfigurer lorsque vous changez celui qui est actif.
Niveaux d'effort de raisonnement par fournisseur
L'ensemble exact des niveaux diffère selon le fournisseur, certains vont plus loin que d'autres.
| Fournisseur | Niveaux |
|---|---|
| OpenAI | Default, Off, Low, Medium, High, Extra High |
| Anthropic Claude | Default, Low, Medium, High, Extra High, Max |
| DeepSeek | Default, Off, High, Max (pas de palier Low ni Medium) |
| Qwen | Default (off, recommandé), Low, Medium, High |
| Kimi | Default, Off, On (un simple on ou off, sans paliers graduels) |
| GLM | Default, Off, On ; un modèle GLM haut de gamme débloque en plus Low, High et Max par-dessus le on ou off de base |
| Google Gemini | Default, Minimal, Low, Medium, High |
Un fournisseur totalement dépourvu de commande de raisonnement, par exemple un fournisseur qui ne prend pas en charge un effort réglable, saute simplement ce champ.
Pas à pas
L'écran est identique pour chaque fournisseur, une fois que vous l'avez fait une fois les autres sont donc rapides. Ces guides pas à pas utilisent des clics et des emplacements exacts.
Connecter une clé OpenAI et se préparer à discuter
- Ouvrez Settings, AI Settings, et restez sur l'onglet Provider & Model.
- Dans la liste de fournisseurs de gauche, cliquez sur OpenAI. Son panneau s'ouvre à droite.
- Sous Step 1, API Key, collez votre clé dans le champ masqué. Si vous n'en avez pas encore, utilisez le petit lien externe à côté du nom du fournisseur pour ouvrir la console développeur d'OpenAI et créer une clé sur sa page API keys, puis revenez la coller. Cliquez sur Save.
- Sous Step 2, Model, choisissez un modèle dans la liste déroulante, ou laissez celui déjà marqué recommended.
- Si une liste déroulante Reasoning apparaît entre l'étape 2 et l'étape 3, choisissez un niveau ou laissez-le sur Default.
- Sous Step 3, Try it, cliquez sur Test connection et attendez le message "Connection successful, key is valid."
- Activez l'interrupteur Use for chat si OpenAI ne porte pas déjà l'étiquette Active. C'est ce qui en fait le fournisseur utilisé par le chat.
- Facultatif : ouvrez l'accordéon Advanced (optional) pour ajouter des instructions Assistant (une invite système), ajuster la Creativity (température), ou plafonner la Max reply length. Chacun de ces champs s'enregistre de lui-même quand vous cliquez ailleurs, il n'y a donc rien d'autre à valider.
Configurer un fournisseur vidéo uniquement comme fal.ai
- Ouvrez l'onglet Settings, AI Settings, Provider & Model, et cliquez sur fal.ai dans la liste de gauche.
- Collez votre clé fal.ai (formée d'un identifiant de clé et d'un secret joints par deux-points) dans le champ API Key et cliquez sur Save. Vous l'obtenez sur la page Keys du tableau de bord fal.ai, accessible depuis le lien externe à côté du nom du fournisseur.
- Remarquez qu'il n'y a ici ni liste déroulante de modèle ni interrupteur Use for chat. fal.ai est un moteur de génération, sa carte affiche donc un badge Video engine à la place, et explique que le modèle réel est choisi plus tard, au moment de la génération.
- Cliquer sur Test renvoie "Key saved (this provider has no live test)" plutôt que de la valider véritablement, car ce fournisseur n'a pas de point de terminaison économique à interroger. C'est attendu, ce n'est pas une erreur.
- Choisissez le modèle au moment de générer : dans le mode Video du composeur (Seedance 2.0, Seedance 2.0 Fast, Veo 3.1, Veo 3.1 Fast ou Kling 2.6), ou dans Marketing Studio. Voir Générer des vidéos pour les commandes de ce mode. BytePlus fonctionne de la même façon, avec un badge Video + image engine, et choisit lui aussi son modèle au moment de la génération.
Changer de fournisseur de chat actif sans perdre vos autres clés
- Ouvrez l'onglet Settings, AI Settings, Provider & Model.
- Dans la liste de gauche, cliquez sur un autre fournisseur qui a déjà une clé enregistrée, signalé par une icône de bouclier.
- Activez son interrupteur Use for chat. Il devient immédiatement le fournisseur de chat Active, et le précédent perd l'étiquette Active de lui-même (vous ne désactivez jamais l'ancien à la main).
Chaque autre fournisseur conserve sa clé, son modèle choisi et son niveau de raisonnement enregistrés, revenir plus tard ne demande donc aucune reconfiguration. Rien de ce que vous avez connecté n'est perdu en changeant celui qui est actif.
Connecter un point de terminaison auto-hébergé ou personnalisé compatible OpenAI
- Ouvrez l'onglet Settings, AI Settings, Provider & Model, et cliquez sur Custom Endpoint dans la liste.
- Saisissez une Base URL et un Model Name au lieu de choisir dans une liste de modèles figée.
- Il n'y a pas de Test connection en direct ici : la zone du bouton affiche "No test for a custom provider, try it in chat" à la place. Envoyez un message dans le chat pour confirmer que cela fonctionne.
- Activez Use for chat pour le rendre actif.
Un point de terminaison personnalisé est le seul fournisseur dont la clé n'est ni chiffrée sur le serveur ni relayée par un proxy, puisqu'il n'y a pas d'hôte fixe par lequel router. Sa clé reste dans votre navigateur et les requêtes partent directement du navigateur vers la Base URL que vous avez saisie, n'utilisez donc qu'un point de terminaison de confiance. C'est le même comportement que celui signalé sous Point de terminaison personnalisé plus bas.
Vos clés sont en sécurité
Les clés sont stockées côté serveur
Votre clé est chiffrée au repos sur le serveur et n'est jamais renvoyée au navigateur. Chaque appel de fournisseur est effectué depuis le serveur en votre nom, la page elle-même ne détient donc jamais votre vraie clé, seulement un espace réservé à sa place.
Tous les fournisseurs ne peuvent pas être testés en direct
Test Connection effectue une vraie requête pour la plupart des fournisseurs. Quelques fournisseurs vidéo uniquement n'exposent pas de point de terminaison adapté à un test en direct, enregistrer la clé y confirme donc simplement qu'elle a été stockée, pas qu'elle fonctionne.
Quels fournisseurs
Les fournisseurs prennent en charge des choses différentes : certains n'alimentent que le chat, certains ne génèrent que des images ou des vidéos, et quelques-uns font les deux. Voir la Matrice des fournisseurs et modèles pour le détail complet par mode.
Point de terminaison personnalisé
Si votre fournisseur parle le format chat completions compatible OpenAI, connectez-le en tant que Custom Endpoint en fournissant une Base URL et un Model Name au lieu de choisir dans une liste figée. C'est la façon d'utiliser un modèle auto-hébergé ou un fournisseur moins courant.
Les points de terminaison personnalisés contournent le proxy serveur
Les fournisseurs nommés sont appelés depuis le serveur, votre navigateur ne leur parle donc jamais directement. Un point de terminaison personnalisé est la seule exception : puisqu'il n'existe pas de route de proxy intégrée pour une URL arbitraire, les requêtes qui lui sont destinées partent directement de votre navigateur vers l'adresse que vous fournissez, et sa clé reste dans le navigateur plutôt que d'être chiffrée côté serveur.
Changer ou retirer une clé
Revenez sur le même onglet de fournisseur à tout moment pour coller une nouvelle clé par-dessus l'ancienne, ou la supprimer complètement. Supprimer une clé ne supprime pas les modèles ni les conversations que vous avez déjà utilisés avec elle, cela empêche simplement ce fournisseur d'être utilisable jusqu'à ce que vous ajoutiez de nouveau une clé. Si le fournisseur que vous supprimez était le fournisseur de chat actif, activez un autre fournisseur connecté avant de revenir au chat.
Si une clé ne fonctionne pas
Un Test Connection échoué signifie presque toujours l'une de quelques choses : la clé a été mal saisie ou comporte des espaces en fin, la clé appartient à un produit différent de la même entreprise, ou le compte derrière la clé n'a pas encore de quota ni de facturation configurés du côté du fournisseur. Le message d'erreur renvoyé par le fournisseur est affiché tel quel, vérifiez-le donc en premier avant de supposer que l'application est en cause.
Dépannage
L'effort de raisonnement se réinitialise sur un nouveau navigateur ou appareil
Contrairement à votre clé API, qui est chiffrée et stockée sur le serveur et vous suit donc sur tout appareil où vous vous connectez, le niveau d'effort de raisonnement que vous choisissez par fournisseur n'est enregistré que dans le stockage local du navigateur courant. Il ne voyage pas vers un autre navigateur, un autre ordinateur, ni une fenêtre privée, où il repart de Default. Si vos réponses vous semblent soudain plus superficielles après un changement de machine, re-choisissez le niveau de raisonnement à cet endroit. Votre clé, votre modèle et vos réglages avancés ne sont pas affectés, seul le niveau de raisonnement est local au navigateur.
Ce que signifie chaque message de Test connection
Test connection convertit une erreur brute du fournisseur en un message court et clair, et est limité à 10 tests par minute par compte.
| Message | Ce qu'il signifie |
|---|---|
| Connection successful, key is valid. | La clé a fonctionné et le fournisseur a répondu. |
| Key saved (this provider has no live test) | fal.ai et BytePlus n'ont pas de point de terminaison économique à interroger, seul l'enregistrement de la clé est donc confirmé. |
| No test for a custom provider, try it in chat | Un point de terminaison personnalisé n'a pas d'action de test ; envoyez un message de chat pour le vérifier. |
| Key is invalid, you may have copied it incompletely | Le fournisseur a rejeté la clé (une erreur de type 401 ou 403). Recopiez-la en entier. |
| Provider is busy (429), try again shortly | Le fournisseur a renvoyé une limite de débit (429). Patientez un instant et réessayez. |
| Could not reach the provider (network/CORS) | Un échec réseau ou CORS a empêché la requête d'arriver. |
| Save your key first. | Il n'y a encore aucune clé enregistrée à tester. |
| Too many tests, try again in a minute. | Vous avez dépassé 10 tests en une minute ; faites une brève pause et réessayez. |
Supprimer une clé n'efface pas ce que vous avez créé
Retirer la clé d'un fournisseur stoppe seulement les nouvelles requêtes vers lui. Votre galerie d'images et de clips générés, ainsi que les conversations que vous avez déjà eues, restent en place. Voir Changer ou retirer une clé plus haut pour les étapes exactes.
Voir aussi
- Utilisez votre propre clé IA
- Matrice des fournisseurs et modèles
- Utiliser le chat IA
- Assistant de chat IA pour la version intégrée à l'éditeur de cette même configuration