Clés IA et API

Toutes les fonctionnalités d'IA et de contenu de banque de l'éditeur fonctionnent avec des clés que vous fournissez vous-même. Cette page indique où les saisir : le fournisseur IA utilisé par l'assistant de discussion, les cinq fournisseurs de médias de banque utilisés par l'onglet Media, et la base de connaissances de recherche vectorielle facultative qui alimente les recettes de design de l'assistant.

Aperçu rapide

1. Ouvrez Settings, puis AI Settings.
2. Choisissez un onglet de fournisseur, collez votre clé API et sélectionnez un modèle.
3. Définissez éventuellement une invite système, une température et un nombre maximal de tokens sous General Settings, puis cliquez sur Save Settings.
4. Utilisez Test Connection pour confirmer que la clé fonctionne avant de compter dessus.
5. Passez à la section Knowledge Base, ou faites défiler jusqu'à Stock Media API Keys, pour les deux autres jeux de clés.

Référence détaillée

Fournisseurs IA

Fournisseur	Notes
Qwen (DashScope)	Le fournisseur par défaut
Kimi (Moonshot)
DeepSeek
GLM (Zhipu)
OpenAI
Google Gemini
Anthropic Claude
Point de terminaison personnalisé	Toute API de complétion de chat compatible OpenAI

Chaque onglet présente un champ de clé API masqué par des points, avec une bascule afficher/masquer, et un sélecteur de modèle sous forme de grille de cartes. L'onglet Custom Endpoint remplace la grille de modèles par un champ Base URL et un champ Model Name, puisqu'il n'y a pas de liste de modèles fixe parmi laquelle choisir. Voir Assistant IA de discussion pour savoir quels fournisseurs prennent en charge la vision et la génération native d'images.

Paramètres généraux

Partagés par tous les fournisseurs.

Paramètre	Plage	Notes
Invite système	Texte libre	Instructions personnalisées facultatives, par exemple pour orienter l'assistant vers un style de design particulier
Température	0 à 2	Étiquetée Precise, Balanced, Creative ou Wild à mesure que vous déplacez le curseur
Nombre maximal de tokens	100 à 32768	Limite la longueur d'une seule réponse

Save Settings enregistre le fournisseur actif, la clé et le modèle ; Test Connection envoie une petite requête pour confirmer que la clé est valide sans attendre une vraie discussion.

Stock Media API Keys

Une liste distincte de clés qui alimentent la recherche dans la médiathèque, sans rapport avec la clé propre à l'assistant de discussion.

Fournisseur	Sert à	Inscription	Notes
Unsplash	Recherche d'images	unsplash.com/oauth/applications	Utilise une Access Key, pas la Secret Key ; environ 50 requêtes/heure sur une application de démonstration non validée, bien plus une fois votre application approuvée pour la production
Pexels	Recherche d'images et de vidéos	pexels.com/api	La clé est délivrée instantanément après votre demande
Pixabay	Recherche d'images, de vidéos et d'audio	pixabay.com/api/docs	Une seule clé couvre les trois types de médias, avec une limite par minute plutôt que par jour
Freesound	Recherche audio	freesound.org/apiv2/apply	Envoyée sous forme de token, pas la valeur brute de la clé, dans la requête
Jamendo	Recherche audio	devportal.jamendo.com	Gratuit pour un usage non commercial
GIPHY	GIF et stickers	developers.giphy.com	Également utilisé par le panneau Emoji, GIF et stickers

Chaque champ possède une bascule Show/Hide et des instructions d'inscription en ligne. Une action Test Keys vérifie toutes les clés configurées d'un coup et rapporte une réussite ou un échec par fournisseur, y compris le code de statut HTTP en cas d'échec, de sorte qu'une clé erronée ou expirée soit facile à distinguer d'un fournisseur simplement en panne.

Knowledge Base

Une base de données vectorielle Qdrant facultative qui alimente la recherche sémantique de l'assistant dans ses recettes de design intégrées. Sans elle, l'assistant se rabat sur une correspondance de mots-clés locale, qui fonctionne tout de même mais avec moins de précision.

Champ	Rôle
Qdrant URL	Le point de terminaison de votre Qdrant Cloud (ou auto-hébergé)
Qdrant API key	S'authentifie auprès de ce point de terminaison
Fournisseur d'embeddings	OpenAI, Qwen, Google ou GLM
Modèle d'embeddings	Selon le fournisseur choisi
Clé API d'embeddings	Facultative ; laissez vide pour réutiliser la clé de votre fournisseur de chat IA

Save & Enable active la recherche Qdrant, Seed Qdrant y pousse le jeu de recettes intégré, et Disable Qdrant revient à la recherche locale sans perdre les détails de connexion.

Skills Manager

Le bouton Customize / Skills en haut de AI Settings ouvre l'éditeur de compétences, où vous créez et attribuez des compétences IA, des profils d'instructions personnalisés déclenchés par une commande slash. Voir Compétences IA pour savoir comment les construire et les utiliser.

Une compétence est structurée comme un petit dossier : une instruction principale SKILL.md plus un ensemble facultatif de documents de référence, chacun avec son propre titre et son contenu, dont la compétence peut s'inspirer.

Élément	Détail
Compétences intégrées	Livrées avec l'éditeur ; leur nom, leur description et leur SKILL.md sont en lecture seule, mais vous pouvez tout de même les attribuer à des fournisseurs
My Skills	Tout ce que vous créez ; entièrement modifiable, y compris SKILL.md, les références, l'icône et la description
Attribution aux fournisseurs	Une grille de cases à cocher vous permet d'activer une compétence pour un ou plusieurs fournisseurs indépendamment, de sorte que différents fournisseurs puissent exécuter différentes compétences
Commande slash	Le nom de chaque compétence est transformé en commande de chat (affichée en direct pendant que vous modifiez le nom), par exemple une compétence nommée « Brand Voice » devient /brand-voice
Duplicate	Fonctionne sur les compétences intégrées comme personnalisées ; dupliquer une compétence intégrée est la façon de commencer à la modifier, puisque l'originale reste verrouillée

Détails de connexion de la Knowledge Base

La section Knowledge Base (une entrée de barre latérale distincte de AI Settings) est l'endroit où l'on saisit et enregistre l'URL Qdrant, la clé et le fournisseur d'embeddings du tableau ci-dessus ; Save & Enable, Seed Qdrant et Disable Qdrant se trouvent tous dans cette section.

Étape par étape

Connecter une clé de fournisseur IA de bout en bout

1. Ouvrez Settings, puis AI Settings.
2. Cliquez sur un onglet de fournisseur (par exemple Qwen, DeepSeek ou Anthropic Claude).
3. Collez votre clé dans le champ API Key, en vous servant de la bascule afficher/masquer pour la vérifier, puis choisissez un modèle dans la grille de cartes (ou, sur Custom Endpoint, renseignez plutôt un champ Base URL et Model Name).
4. Définissez éventuellement une invite système, une température et un nombre maximal de tokens sous General Settings.
5. Cliquez sur Save Settings, puis sur Test Connection pour confirmer que la clé fonctionne réellement avant de compter dessus dans une discussion.

Configurer une clé de média de banque et la vérifier

1. Faites défiler jusqu'à Stock Media API Keys, plus bas dans AI Settings.
2. Inscrivez-vous sur le site du fournisseur listé ci-dessus et copiez la clé qu'il délivre.
3. Collez-la dans le champ correspondant et cliquez sur Save API Keys.
4. Cliquez sur Test Keys ; chaque fournisseur configuré rapporte OK ou une erreur HTTP précise en ligne, vous savez donc immédiatement si une clé doit être corrigée.

Créer une compétence IA personnalisée et la déclencher

1. Cliquez sur Customize / Skills en haut de AI Settings.
2. Cliquez sur New Skill, donnez-lui un nom et une description, et choisissez une icône.
3. Rédigez vos instructions dans l'éditeur SKILL.md ; ajoutez un ou plusieurs documents de référence depuis l'arborescence de fichiers si la compétence a besoin de matériel de support au-delà de l'instruction principale.
4. Cochez le ou les fournisseurs sur lesquels vous la voulez disponible dans la grille Provider Assignment, puis enregistrez.
5. Dans la discussion IA, saisissez la commande slash de la compétence (affichée dans l'aperçu sous l'éditeur) pour la déclencher.

Activer la base de connaissances Qdrant

1. Ouvrez Settings, puis Knowledge Base.
2. Saisissez votre URL Qdrant et votre clé API, choisissez un fournisseur et un modèle d'embeddings, et éventuellement une clé API d'embeddings distincte (laissez-la vide pour réutiliser la clé de votre fournisseur de chat IA).
3. Cliquez sur Save & Enable, puis sur Seed Qdrant pour y pousser le jeu de recettes intégré.
4. Si vous voulez revenir à la correspondance de mots-clés locale, cliquez sur Disable Qdrant ; vos détails de connexion sont conservés, de sorte qu'une réactivation ultérieure ne vous oblige pas à les ressaisir.

Tâches courantes

Tâche	Étapes
Changer de fournisseur actif sans perdre les autres clés	Cliquez sur un autre onglet de fournisseur et enregistrez ; la clé de chaque fournisseur est stockée indépendamment
Attribuer une compétence uniquement à votre fournisseur le plus rapide	Décochez-la pour tous les autres fournisseurs dans la grille Provider Assignment de cette compétence
Commencer à modifier une compétence intégrée	Ouvrez-la, cliquez sur Duplicate, puis modifiez la copie dans My Skills
Confirmer qu'un Custom Endpoint fonctionne vraiment	Il n'y a pas de liste de modèles pour vérifier, envoyez donc un vrai message de discussion après l'enregistrement plutôt que de vous fier uniquement à Test Connection
Libérer une connexion de base de connaissances sans perdre les recettes qui y ont été injectées	Utilisez Disable Qdrant au lieu d'effacer les champs URL et clé

Dépannage

Une clé manquante affiche une invite, pas un échec silencieux

Les deux panneaux de recherche de banque et le panneau d'items GIF/sticker affichent un message explicite « ajoutez votre clé » renvoyant vers les paramètres lorsqu'une clé requise est absente, plutôt que de renvoyer des résultats vides.

Test Keys rapporte le statut HTTP par fournisseur

Un test échoué affiche le code de statut HTTP réel renvoyé par ce fournisseur (par exemple un 401 pour une clé erronée contre un 429 pour une limitation de débit), vous pouvez ainsi distinguer une faute de frappe d'une panne temporaire du fournisseur.

Les compétences intégrées ne peuvent pas être modifiées ni supprimées sur place

Leurs champs nom, description et SKILL.md sont en lecture seule, et il n'y a pas de bouton de suppression. Dupliquez d'abord une compétence intégrée pour obtenir une copie modifiable et supprimable dans My Skills.

Astuces

Gardez la clé de chat et les clés de banque séparées

La clé de fournisseur IA pilote la conversation et la génération ; les clés de médias de banque n'alimentent que la recherche dans l'onglet Media. Configurer l'une ne configure pas l'autre.

Testez avant de compter dessus

Les API des fournisseurs changent leurs formats de clé et leurs limites de débit au fil du temps. Lancez Test Connection ou Test Keys après avoir collé une clé, plutôt que de découvrir une faute de frappe au milieu d'un design.

Liens connexes

• Assistant IA de discussion pour ce que prend en charge chaque fournisseur
• Compétences IA pour créer et déclencher des compétences personnalisées
• Médiathèque et contenu de banque pour ce que débloquent les clés de banque
• Paramètres de l'éditeur pour le reste de l'écran des paramètres