# Configurer un modèle personnalisé dans WorkBuddy > Configurez un modèle personnalisé dans WorkBuddy en trois étapes : ouvrez Ajouter un modèle, choisissez Personnalisé, saisissez l'URL, la clé et l'ID du modèle. - Canonical HTML: https://omniakey.com/fr/blog/workbuddy-custom-model-setup - Markdown: https://omniakey.com/fr/blog/workbuddy-custom-model-setup.md - Published: 2026-08-20 (updated 2026-09-21) - Author: Kiki, COO at OmniaKey - Language: fr - Category: API setup - Reading time: 8 min - All posts: https://omniakey.com/blog/llms.txt --- Ce guide utilise l'interface actuelle de modèle personnalisé WorkBuddy. Préparez une clé OmniaKey API et un identifiant de modèle exact avant d'ouvrir le WorkBuddy. > **Le formulaire terminé :** choisissez **Personnalisé**, saisissez `https://api.omniakey.com/v1`, collez votre clé OmniaKey API et utilisez un ID de modèle exact tel que `deepseek-v4-flash`. Le formulaire, les détails du modèle enregistrés et le sélecteur de modèle ont été vérifiés dans l'application macOS exécutant WorkBuddy `v5.3.14`. Les instructions officielles de Tencent Cloud nécessitent au moins `v4.22.15` pour cette fonctionnalité. |Champ WorkBuddy|Valeur| |-|-| |Fournisseur|`Custom` sous le groupe **Autre**| |Adresse de l'interface|`https://api.omniakey.com/v1`| |Clé API|Une clé créée dans OmniaKey| |Nom du modèle|Par exemple, `deepseek-v4-flash`| ## Avant de commencer, préparez deux éléments ### Une clé OmniaKey API Connectez-vous à OmniaKey et ouvrez la [Page Clés API](https://omniakey.com/fr/dashboard/tokens) : 1. Sélectionnez **Créer une clé**. 2. Nommez-le `WorkBuddy`, puis définissez une limite et une expiration appropriées. 3. Créez-le et copiez immédiatement la nouvelle clé. Gardez la boîte de dialogue de clé ouverte jusqu'à ce que vous ayez collé les informations d'identification dans WorkBuddy. Ne placez pas la clé dans des captures d'écran, des messages de discussion ou des fichiers publics. Le compte a également besoin d'un solde disponible ou d'un crédit d'essai. La création d'une clé crée uniquement un identifiant ; cela ne garantit pas que le compte puisse financer une demande. La même clé fonctionne dans d'autres outils ; consultez les guides [configurer l’API de Cherry Studio](https://omniakey.com/fr/blog/cherry-studio-api-setup), [clé API personnalisée dans Cline](https://omniakey.com/fr/blog/cline-custom-api-key) et [configurer Claude Code](https://omniakey.com/fr/blog/claude-code-setup). ### Un identifiant de modèle exact Ouvrez le [Catalogue de modèles OmniaKey](https://omniakey.com/fr/models), choisissez un modèle actuellement disponible et copiez l'ID de modèle affiché sur la page. Pour un premier test, utilisez : ```text deepseek-v4-flash ``` L'identifiant doit correspondre exactement. N'entrez pas le nom d'affichage `DeepSeek V4 Flash`, ne supprimez pas les traits d'union et n'inventez pas un alias plus court. ## Étape 1 : Ouvrir Ajouter un modèle Démarrez WorkBuddy et ouvrez : ```text System Settings → Models → + Add model ``` Sur la page Modèles, sélectionnez **+ Ajouter un modèle** dans le coin supérieur droit. ![Page de paramètres des modèles WorkBuddy avec le bouton Ajouter un modèle dans le coin supérieur droit](https://omniakey.com/_img/blog/workbuddy-custom-model-setup/01-open-model-settings.2eba6570.1000.webp) _Étape 1 : Paramètres système → Modèles → + Ajouter un modèle._ Vous pouvez également saisir par le bas une nouvelle tâche : ```text Model picker → + Configure custom model ``` Si aucune des deux entrées n'est disponible, mettez à jour WorkBuddy vers la version `v4.22.15` ou une version ultérieure. Les instructions actuelles de Tencent Cloud nécessitent au moins cette version pour l'interface. ## Étape 2 : choisissez Personnalisé et remplissez quatre champs Remplissez le formulaire de haut en bas. ### 1. Choisissez le fournisseur personnalisé Ouvrez le menu Fournisseur et sélectionnez : ```text Custom ``` Dans `v5.3.14`, il apparaît sous le groupe **Autre**. Ne choisissez pas le OpenAI intégré, le Tencent Cloud Token Plan ou un autre fournisseur, car ces profils n'utilisent pas l'adresse d'interface OmniaKey. ![Option de fournisseur personnalisé en bas du menu Fournisseur WorkBuddy](https://omniakey.com/_img/blog/workbuddy-custom-model-setup/02-choose-custom-provider.fabcb941.560.webp) _Étape 2 : faites défiler vers le bas du menu Fournisseur et choisissez Personnalisé sous Autre._ ### 2. Entrez l'adresse via `/v1` Dans **Adresse d'interface** ou **Base URL**, saisissez exactement : ```text https://api.omniakey.com/v1 ``` > **Ne copiez pas l'espace réservé gris.** Il montre un exemple se terminant par `/v1/chat/completions`, mais OmniaKey utilise Base URL `https://api.omniakey.com/v1` dans ce champ. ### 3. Collez la clé API Collez la clé que vous avez copiée de OmniaKey dans **API Key**. N'ajoutez pas de guillemets, d'espaces ou le mot `Bearer` ; entrez uniquement la valeur clé. ### 4. Entrez le nom du modèle Sous **Nom du modèle** ou **Model ID**, saisissez l'ID de catalogue exact : ```text deepseek-v4-flash ``` Le formulaire principal devrait maintenant se lire : ```text Provider: Custom Interface address: https://api.omniakey.com/v1 API Key: [your OmniaKey API key] Model name: deepseek-v4-flash ``` ![Formulaire de modèle personnalisé WorkBuddy rempli avec l'adresse de l'interface OmniaKey et le nom du modèle deepseek-v4-flash](https://omniakey.com/_img/blog/workbuddy-custom-model-setup/03-fill-omniakey-fields.addb54d9.560.webp) _Exemple terminé. La clé API est intentionnellement vide dans la capture d'écran ; collez votre propre clé OmniaKey lors de la configuration de WorkBuddy._ Pour le premier test de connexion, laissez les champs restants avec leurs valeurs par défaut et assurez-vous que **Protocole personnalisé** est désactivé. Dans `v5.3.14`, un nouveau formulaire commence par Tool calling activé, la saisie d'image désactivée, le mode de raisonnement désactivé, le protocole personnalisé désactivé et les limites d'entrée et de sortie par défaut du fournisseur. Un préréglage `deepseek-v4-flash` vérifié apparaît ci-dessous. ## Étape 3 : Enregistrez, sélectionnez le modèle et testez-le Sélectionnez **Enregistrer** et revenez à une nouvelle tâche. Ouvrez le sélecteur de modèle en bas, recherchez la section modèle personnalisé et choisissez `deepseek-v4-flash`. Envoyez un court message de test : ```text Reply with exactly: Connection successful ``` Une réponse normale confirme quatre parties de la configuration à la fois : 1. WorkBuddy a enregistré le fournisseur personnalisé. 2. Le Base URL est correct. 3. La clé API est acceptée et dispose d'un crédit utilisable. 4. La clé peut accéder à l'ID du modèle sélectionné. Enfin, ouvrez [OmniaKey Usage](https://omniakey.com/fr/dashboard/usage) et confirmez que l'appel apparaît avec le modèle attendu. Cela ferme la boucle de vérification de WorkBuddy à OmniaKey. Si le modèle enregistré n'apparaît pas immédiatement, fermez et rouvrez le sélecteur. Quittez complètement et redémarrez WorkBuddy s'il n'apparaît toujours pas. ## Paramètres avancés recommandés pour le premier test Ne modifiez pas plusieurs contrôles de fonctionnalités avant que le chat de base ne fonctionne. Un nouveau modèle personnalisé dans WorkBuddy `v5.3.14` commence par : |Options|Nouveau formulaire par défaut| |-|-| |Tool calling|Sur| |Saisie d'images|Désactivé| |Mode de raisonnement|Désactivé| |Protocole personnalisé|Désactivé| |Limites d'entrée et de sortie|Valeurs par défaut du fournisseur| Utilisez ces valeurs par défaut pour vérifier d'abord l'URL, la clé et le nom du modèle. Ajustez ensuite les capacités du modèle. ### Préréglage `deepseek-v4-flash` vérifié Le modèle enregistré et les réponses locales réussies utilisaient cette configuration : |Options|Paramètre `deepseek-v4-flash`| |-|-| |Tool calling|Désactivé| |Saisie d'images|Désactivé| |Mode de raisonnement|**Activé**| |Raisonnement uniquement|Désactivé| |Autoriser le raisonnement désactivé|**Activé**| |Protocole personnalisé|**Désactivé**| |Effort de raisonnement par défaut|`Auto (use request-layer default)`| |Efforts de raisonnement soutenus|Laissez Low, Medium, High, Extra High et Maximum décochés| |Limites d'entrée et de sortie|Valeurs par défaut du fournisseur| WorkBuddy révèle le raisonnement uniquement, autorise la désactivation du raisonnement et les contrôles d'effort une fois le mode raisonnement activé. Laissez l'effort sur Auto pour le premier test. ### Quand activer l’appel d’outil Activez **Tool calling** lorsque WorkBuddy doit lire des fichiers, utiliser des connecteurs ou effectuer des tâches d'agent. Le modèle doit également prendre en charge les appels d'outils structurés. `deepseek-v4-flash` dispose actuellement d'un support d'outils dans le catalogue OmniaKey, alors activez-le après les travaux de discussion de base et commencez par une tâche en lecture seule. Il peut rester désactivé pendant un test de chat en connexion uniquement. ### Quand activer la saisie d’images Activez-le uniquement pour un modèle explicitement marqué comme acceptant des images. Un commutateur client ne peut pas ajouter de fonctionnalité de vision à un modèle texte uniquement. ### Quand activer le mode raisonnement Activez-le lorsque le catalogue ou la documentation du modèle répertorie explicitement le raisonnement, la réflexion ou un mode similaire. Conserver l'effort automatique et autoriser le raisonnement invalidant. N'ajoutez pas de valeurs d'effort non prises en charge et ne faites pas du mode raisonnement uniquement le mode par défaut pour les tâches ordinaires. ## Ajout d'un autre modèle personnalisé WorkBuddy N'écrasez pas une entrée de modèle de travail. Ouvrez à nouveau **Ajouter un modèle**, conservez la même URL OmniaKey et la même clé API, remplacez uniquement l'ID de modèle exact et enregistrez-le en tant qu'autre modèle personnalisé. Vérifiez un modèle avant d’ajouter le suivant. Lorsqu'un problème apparaît, cela indique clairement quelle entrée enregistrée l'a introduit. ## Dépannage par symptôme ### Configurer le modèle personnalisé est manquant Vérifiez d'abord la version WorkBuddy. Mettez à jour vers `v4.22.15` ou une version ultérieure, puis recherchez dans le sélecteur de modèle de nouvelle tâche ou sous **Paramètres système → Modèles**. ### HTTP 401, Clé API non autorisée ou invalide Copiez à nouveau la clé OmniaKey. Vérifiez les espaces et assurez-vous de ne pas avoir collé `Bearer` avec. Confirmez que la clé est activée et n'a pas expiré, et que le solde du compte et la limite de clé sont utilisables. La modification de l'ID de modèle ne corrige pas un `401` ; l'authentification a échoué avant que la sélection du modèle ne soit importante. ### HTTP 404 ou point de terminaison introuvable L'adresse doit être exactement : ```text https://api.omniakey.com/v1 ``` N'utilisez pas le domaine nu, ne dupliquez pas `/v1` ou n'ajoutez pas `/chat/completions`. Assurez-vous également que le **Protocole personnalisé** est désactivé. ### Modèle introuvable ou `UNKNOWN_MODEL` Copiez à nouveau l'ID à partir du [catalogue de modèles dynamiques](https://omniakey.com/fr/models). Un nom d’affichage, un alias deviné ou un identifiant retiré n’est pas un identifiant de modèle actuel valide. ### Le chat fonctionne mais les outils échouent La connexion du modèle de base fonctionne déjà. VérifierWorkBuddyc'estTool callingcommutateur et la capacité de l'outil du modèle. Rentrer dans leAPIla clé ou l’URL n’ajoutera pas la prise en charge de l’outil. ### La saisie de l'image échoue Les deux conditions doivent être vraies : le modèle prend en charge les images et le contrôle d'entrée d'image de WorkBuddy est activé. ### Le modèle est manquant après l'enregistrement Confirmez que vous avez sélectionné **Enregistrer**, puis rouvrez le sélecteur de modèle. Redémarrez WorkBuddy si nécessaire. Si l'entrée de configuration elle-même n'est pas disponible, vérifiez à nouveau la version du client. ## Questions fréquemment posées ### Quelle URL OmniaKey WorkBuddy doit-elle utiliser ? Utilisez uniquement `https://api.omniakey.com/v1`. Il s'agit d'un Base URL ; WorkBuddy ajoute le chemin d’accès à l’opération. ### Ai-je besoin d’un fichier `models.json` ? Non. Ce guide suit l'interface **Configurer le modèle personnalisé** actuelle. Les anciennes instructions du fichier de configuration local décrivent un chemin d’installation différent. ### Puis-je configurer GPT, Claude, Gemini ou un autre modèle ? Oui, lorsque le modèle est actuellement répertorié dans OmniaKey et prend en charge l'itinéraire compatible OpenAI. Conservez la même URL et utilisez l’ID exact du modèle de catalogue. ### MCP est-il configuré sur ce formulaire ? Non. Ce formulaire configure le modèle API. MCP et les connecteurs sont des paramètres WorkBuddy distincts. Établissez une réponse de modèle de base avant d’ajouter ces outils. ## Références vérifiées - [Tencent Cloud : configurer et utiliser WorkBuddy](https://cloud.tencent.com/document/product/1823/130064) - [Référence OmniaKey OpenAI compatible API](https://docs.omniakey.com/en/api/openai-compatible) - [Catalogue de modèles dynamiques OmniaKey](https://omniakey.com/fr/models)