|

Zed veut changer de modèle ? Connectez APIYI via un point de terminaison compatible OpenAI : 2 configurations de fournisseur

ParShark
Zed veut changer de modèle ? Connectez APIYI via un point de terminaison compatible OpenAI : 2 configurations de fournisseur

Note de l’auteur : distinguer les trois chemins d’Agent dans Zed, puis connecter APIYI à Zed via deux fournisseurs personnalisés, OpenAI-compatible et Anthropic-compatible, en précisant l’URL de base, les ID de modèles, les prix et les points clés de dépannage.

Vous codez dans Zed avec le panneau Agent ou l’Inline Assistant, vous voulez passer à un autre modèle, et vous découvrez que la page de paramètres contient plusieurs entrées — LLM Providers, External Agents, fils de terminal — sans savoir où mettre la clé. Cas encore plus fréquent : vous renseignez une passerelle tierce et vous récoltez des 404 ou des échecs d’authentification en boucle. Cet article décrit la procédure complète pour brancher une passerelle de modèles tierce via un fournisseur personnalisé Zed (OpenAI-compatible / Anthropic-compatible), en déroulant la configuration avec APIYI comme exemple.

Ce n’est pas un énième mémo « copiez-collez la config et c’est réglé ». L’article commence par délimiter ce que chacune des trois voies AI de Zed accepte en matière de modèles, puis propose deux itinéraires qu’on peut suivre tel quel. Le détail le plus piégeux — quand ajouter /v1 à l’URL de base et quand ne pas le faire — fait l’objet d’une section séparée.

L’essentiel : à la fin de votre lecture, vous saurez quelle couche de configuration modifier, et vous aurez mis un modèle comme claude-opus-5-5 ou claude-sonnet-5-5 à la disposition de l’Agent Zed en 5 minutes. En cas de problème, vous saurez aussi quoi vérifier en premier.

zed-custom-llm-provider-openai-compatible-apiyi-fr-image-0

Points clés du changement de modèle dans Zed : distinguer d’abord les trois parcours Agent

Zed est un éditeur collaboratif haute performance créé par l’équipe à l’origine d’Atom / Tree-sitter. Au 13 novembre 2026, le dépôt GitHub zed-industries/zed compte environ 94 884 stars (observation via l’API GitHub). La page officielle des releases indique que la version stable du 11 novembre 2026 est la 1.28.1, et la Preview du même jour la 1.29.1. macOS, Linux et Windows sont disponibles en téléchargement direct ; la version Web n’est pas encore officiellement disponible.

Avant de changer de modèle dans Zed, il faut comprendre une chose : la documentation officielle répartit les capacités IA en trois parcours, et chaque parcours a sa propre façon d’intégrer les modèles et de gérer l’authentification. Si vous vous trompez d’endroit, la configuration ne prendra pas effet, et la clé ne sera pas lue par un autre parcours.

Parcours D’où viennent les modèles Qui gère l’authentification Usage typique
Zed Agent LLM Providers（hébergés par Zed, clés des fournisseurs, abonnements, passerelles, modèles locaux） Zed lui-même, clé stockée dans le trousseau de clés système Panneau Agent, Inline Assistant, outils intégrés / profiles / skills / MCP
External Agents（ACP） L’Agent externe choisit lui-même son modèle L’Agent externe gère lui-même Exécuter Claude Agent, Codex, OpenCode, Copilot, Cursor, etc. dans un thread Zed
Terminal Threads Déterminé par le CLI / TUI que vous lancez Configuration propre au CLI Lancer directement divers Agent CLI dans un thread de terminal

Frontière d’intégration entre Zed Agent et External Agent

« Changer de modèle pour Zed Agent » signifie configurer les LLM Providers, c’est-à-dire la couche API Access : c’est la ligne principale de cet article. Les fournisseurs officiels de premier rang sont Anthropic, OpenAI, Google AI, Mistral, DeepSeek, xAI, OpenCode, et deux types de points de terminaison personnalisés sont également proposés : Anthropic-compatible et OpenAI-compatible. Les passerelles tierces se connectent via ces deux types de points de terminaison personnalisés.

Si vous voulez simplement utiliser Claude Agent ou OpenCode dans le panneau, cela relève des External Agents, via l’Agent Client Protocol (ACP). Dans ce cas, le thread est hébergé par Zed, mais le runtime, l’authentification et la sélection du modèle sont généralement gérés par l’Agent externe lui-même. La clé que vous saisissez dans LLM Providers n’est pas automatiquement partagée avec lui ; Claude Agent doit exécuter /login dans son propre thread. Les External Agents peuvent être installés via le registre ouvert par la palette de commandes zed: acp registry. Selon la documentation officielle, Zed ne facture pas séparément les External Agents ; la facturation incombe au fournisseur de l’Agent.

zed-custom-llm-provider-openai-compatible-apiyi-fr-image-1

Points clés de configuration d’un provider personnalisé dans Zed

La différence entre les deux types de points de terminaison personnalisés tient principalement au format des requêtes. Les points de terminaison compatibles OpenAI passent par Chat Completions, ceux compatibles Anthropic par l’API Messages (/v1/messages). Cette différence détermine directement la forme de l’URL de base, mais aussi la possibilité de bénéficier de la facturation Prompt Cache.

Élément de configuration Compatible OpenAI Compatible Anthropic
Format de requête /v1/chat/completions /v1/messages
api_url APIYI https://api.apiyi.com/v1 https://api.apiyi.com (sans /v1)
Champ du modèle available_models[].name + max_tokens available_models
Options de capacités Par défaut tools=true, images=false, chat_completions=true Peut configurer capabilities.prompt_caching
Facturation du cache La documentation APIYI indique que cela ne s’applique pas S’applique avec le format Messages natif
Cas d’usage Pour brancher plusieurs modèles derrière un seul provider Pour utiliser principalement Claude, avec un contexte long et besoin de cache

Pourquoi ajouter /v1 à une URL de base et pas à l’autre

D’après la FAQ Base URL d’APIYI (documentation vérifiée le 2026-11-13), les clients compatibles OpenAI ajoutent directement /chat/completions à la suite de api_url ; il faut donc renseigner api_url au niveau /v1. Côté Anthropic, le client ajoute lui-même /v1/messages, on ne peut donc saisir que le domaine racine. Si vous mettez https://api.apiyi.com/v1, la requête finale devient /v1/v1/messages et renvoie directement une 404.

Il y a deux autres points à garder en tête. La clé API de Zed est stockée dans le trousseau système et n’est pas écrite dans settings.json ; si la variable d’environnement correspondante n’est pas vide, elle a priorité sur le trousseau. Par ailleurs, pour les modèles qui ne prennent en charge que l’interface Responses, il faut mettre capabilities.chat_completions à false, sinon Zed les appellera via Chat Completions.

Démarrage rapide : connecter Zed à APIYI

Vous pouvez choisir l’une des deux approches ci-dessous, ou configurer les deux et basculer entre elles dans le sélecteur de modèle. Avant de vous lancer, préparez votre clé.

🚀 Démarrage rapide : une fois connecté, créez un jeton sur la page des jetons APIYI api.apiyi.com/token. L’idéal est d’en créer un dédié à Zed, pour suivre facilement la consommation et pouvoir le révoquer à tout moment. La documentation de démarrage rapide docs.apiyi.com/getting-started met aussi à disposition skill.md / llms.txt, pratiques pour permettre à l’Agent de lire les explications de la plateforme.

Option A : connecter Zed via un endpoint OpenAI-compatible

  1. Ouvrez les paramètres Agent : exécutez agent: open settings dans la palette de commandes. Le nom de l’entrée peut varier légèrement selon les versions ; fiez-vous à la section LLM Providers de la page de paramètres AI / Agent.
  2. Dans la section LLM Providers, cliquez sur Add Provider et choisissez le type OpenAI-compatible.
  3. Donnez au provider le nom que vous voulez, par exemple apiyi, qui correspond à language_models.openai_compatible.apiyi dans settings.json.
  4. Renseignez l’API URL https://api.apiyi.com/v1. Le /v1 est obligatoire ici : c’est aussi la forme indiquée sur la page OpenAI-compatible d’APIYI.
  5. Collez la clé API tout juste créée ; Zed la stockera dans le trousseau du système.
  6. Ajoutez un modèle : dans le champ name, saisissez l’ID réel figurant dans le tableau des modèles APIYI, par exemple claude-opus-5-5, claude-sonnet-5-5, ou encore claude-fable-5-2. Renseignez max_tokens selon la documentation du modèle ; en cas de doute, partez sur une valeur prudente, puis augmentez-la une fois que tout fonctionne.
  7. Laissez les options de capacités par défaut (tools=true). N’activez images manuellement que si vous devez envoyer des images.
  8. Revenez au panneau Agent et cherchez apiyi ou le nom du modèle dans le sélecteur de modèle. Les versions récentes du sélecteur gèrent la recherche approximative ; une fois le modèle sélectionné, envoyez un message pour vérifier.

L’avantage de cette approche : un seul provider peut héberger plusieurs modèles. La documentation APIYI précise qu’avec l’endpoint OpenAI-compatible /v1/chat/completions, il suffit de modifier la chaîne du modèle à un seul endroit pour en changer.

Route B : brancher Zed sur le point de terminaison compatible Anthropic

  1. Là encore, allez dans LLM Providers → Add Provider, puis choisissez le type Anthropic-compatible.
  2. Dans le champ API URL, saisissez https://api.apiyi.com, en indiquant uniquement le domaine racine, sans /v1. Les requêtes arriveront en réalité sur le point de terminaison Anthropic natif d’APIYI : https://api.apiyi.com/v1/messages.
  3. Collez le même jeton, ou créez-en un autre dédié.
  4. Dans available_models, ajoutez des ID comme claude-opus-5-5, claude-sonnet-5-5.
  5. Si vous voulez que les conversations à long contexte profitent du cache, activez capabilities.prompt_caching. Comme l’explique la page des capacités Claude d’APIYI, la facturation du cache ne s’applique qu’au format natif Messages.
  6. Sélectionnez ce modèle dans le sélecteur de modèles, puis envoyez un message pour tester.

💡 Conseil de choix : si vous travaillez surtout avec Claude au quotidien, sur des sessions longues où vous relisez sans cesse les mêmes fichiers, la route B est plus avantageuse. Si vous basculez fréquemment entre plusieurs modèles, la route A est plus simple. Les deux routes peuvent utiliser le même jeton APIYI ; il suffit de changer de modèle dans le sélecteur de Zed selon la tâche.

zed-custom-llm-provider-openai-compatible-apiyi-fr-image-2

Référence des prix des modèles Claude (données au 2026-11-13)

Les données ci-dessous proviennent du tableau général des modèles APIYI, vérifié dans la documentation le 2026-11-13, exprimées en dollars US par 1M tokens, avec facturation à l’usage.

ID du modèle Entrée Sortie Lecture du cache Points de terminaison pris en charge Plateforme disponible
claude-opus-5-5 $4 $20 $0.2 chat + messages APIYI apiyi.com
claude-opus-5-5-thinking Identique à opus-5-5 Identique à opus-5-5 Identique à opus-5-5 Voir le tableau général APIYI apiyi.com
claude-sonnet-5-5 $2 $10 $0.1 Voir le tableau général APIYI apiyi.com
claude-fable-5-2 $8 $40 $0.2 Voir le tableau général APIYI apiyi.com

Les modèles et les prix font foi sur la liste des modèles de la plateforme. Avant de configurer, vous pouvez ouvrir docs.apiyi.com/models pour vérifier les chiffres et les groupes du jour (dans le tableau général, la ligne claude-opus-5-5 comporte les groupes ClaudeCode, Claude_Reverse, Claude_Enterprise, Default, SVIP, etc.).

Concernant les limitations d’utilisation de claude-opus-5-5, l’annonce de mise en ligne d’APIYI (2026-09-23) mentionne trois points : la réflexion ne peut pas être définie sur disabled ; tool_choice défini sur any / tool renvoie une erreur 400 ; l’effort est par défaut à medium. Si l’agent Zed renvoie une erreur 400 lors de l’appel d’outils, vérifiez d’abord ces points.

Dépannage des erreurs courantes des points de terminaison personnalisés dans Zed

Quand un fournisseur personnalisé pose problème, la cause se trouve le plus souvent à l’un de ces trois endroits : l’URL, la clé ou le nom du modèle. Le tableau ci-dessous classe les erreurs par fréquence ; vous pouvez vérifier point par point.

Symptôme Cause fréquente Solution
404 Not Found En mode Anthropic-compatible, vous avez mis /v1 : le chemin devient /v1/v1/messages Revenir au domaine racine https://api.apiyi.com
404 / chemin incorrect En mode OpenAI-compatible, il manque /v1 Utiliser https://api.apiyi.com/v1
401 / échec d’authentification Jeton erroné, supprimé, ou variable d’environnement qui écrase le trousseau Revérifier sur api.apiyi.com/token et supprimer les variables d’environnement en conflit
Modèle introuvable ID mal orthographié ou alias utilisé Copier l’ID original depuis docs.apiyi.com/models
400 (appel d’outil) tool_choice défini sur any / tool, ou tentative de désactiver la réflexion Ajuster selon les instructions publiées en ligne
Image non valide OpenAI-compatible a images=false par défaut Activer images dans capabilities
Erreur sur un modèle qui ne prend en charge que Responses Le modèle est toujours appelé via Chat Completions Définir capabilities.chat_completions sur false

🎯 Conseil de dépannage : en cas de 404, comparez mot pour mot l’api_url des paramètres de Zed avec l’URL de base d’APIYI indiquée dans la FAQ (docs.apiyi.com/faq/base-url-config). La plupart des problèmes viennent simplement d’un /v1 en trop ou manquant.

zed-custom-llm-provider-openai-compatible-apiyi-fr-image-3

Avertissement sur les risques liés à l’utilisation d’un Provider personnalisé dans Zed

  • Hébergement non officiel : les Providers personnalisés OpenAI-compatible / Anthropic-compatible sont des capacités d’accès génériques proposées par Zed ; les passerelles tierces ne font pas partie des services hébergés officiellement par Zed. En cas de problème de service, il faut s’adresser au fournisseur de la passerelle.
  • La clé et la facturation sont à votre charge : les jetons et la facturation de l’usage relèvent de votre propre compte. Nous vous conseillons de créer un jeton dédié à Zed, de vérifier régulièrement la consommation d’usage, et de ne pas écrire la clé dans settings.json puis la committer dans le dépôt Git. Zed utilise par défaut le trousseau système (Keychain) pour le stockage, ce qui réduit déjà ce risque.
  • Les conditions des External Agents relèvent du fournisseur : les abonnements, quotas et conditions d’utilisation des agents externes tels que Claude Agent ou Codex sont définis par leurs fournisseurs respectifs, et sont indépendants de la configuration des Providers de Zed Agent.
  • Différences entre versions : la description de l’interface dans cet article repose sur la documentation officielle et les informations des releases pour 1.28.x / 1.29.x (date d’observation : 2026-11-13) ; les noms des entrées pourront être ajustés dans les versions ultérieures.

FAQ – Questions fréquentes

Q1 : Qu’est-ce que le point de terminaison OpenAI-compatible de Zed ?

C’est un type de Provider personnalisé parmi les LLM Providers. Dès lors que le serveur implémente l’interface Chat Completions, il est possible de le connecter à Zed Agent via api_url et la liste des modèles, sans attendre une adaptation officielle de Zed.

Q2 : La clé renseignée dans LLM Providers peut-elle être utilisée directement par Claude Agent ?

Non. Claude Agent est un External Agent, l’authentification est gérée par lui-même, et il faut exécuter `/login` dans son fil de conversation. La clé dans LLM Providers sert uniquement à Zed Agent.

Q3 : Faut-il choisir OpenAI-compatible ou Anthropic-compatible ?

Si vous utilisez principalement Claude et que vous avez besoin de la facturation avec cache, choisissez Anthropic-compatible ; si vous voulez un seul Provider pour plusieurs fournisseurs de modèles, choisissez OpenAI-compatible. Selon la documentation APIYI, la facturation avec cache ne s’applique qu’au format natif Messages.

Q4 : Quel ID de modèle faut-il saisir ?

Saisissez l’ID original figurant dans le tableau récapitulatif des modèles de la plateforme, par exemple `claude-opus-5-5`, `claude-sonnet-5-5`, `claude-fable-5-2`. Nous vous conseillons de copier directement depuis docs.apiyi.com/models, pour éviter une faute de frappe qui provoquerait une erreur « modèle inexistant ».

Q5 : Après configuration, j’obtiens toujours une 404, comment diagnostiquer ?

Vérifiez d’abord `/v1` : OpenAI-compatible doit l’inclure, Anthropic-compatible ne doit pas l’inclure. Si le chemin est correct, vérifiez ensuite que l’ID du modèle correspond bien à la liste des modèles APIYI.

Q6 : Où est stockée la clé API ? Sera-t-elle synchronisée vers le dépôt ?

Zed stocke la clé dans le trousseau système, sans l’écrire dans settings.json ; le partage du fichier de configuration n’expose donc pas la clé. À noter : une variable d’environnement du même nom, si elle est non vide, a la priorité sur le trousseau ; en cas de 401, n’oubliez pas de vérifier les variables d’environnement.

Q7 : Quelles sont les limitations connues de cette configuration ?

OpenAI-compatible n’active pas la capacité d’images par défaut ; la réflexion de `claude-opus-5-5` ne peut pas être désactivée, et définir `tool_choice` sur any / tool renvoie une erreur 400. Par ailleurs, un Provider personnalisé n’est pas un service hébergé officiellement par Zed ; sa stabilité dépend du fournisseur de la passerelle.

Points clés pour connecter Zed à APIYI (Key Takeaways)

  • D’abord, distinguez les parcours : Zed Agent passe par LLM Providers, tandis qu’External Agent gère lui-même l’authentification.
  • Deux types d’endpoints : la compatibilité OpenAI passe par chat, la compatibilité Anthropic passe par messages.
  • Règle d’URL : pour la compatibilité OpenAI, renseignez /v1 ; pour Claude natif, indiquez uniquement le domaine racine.
  • ID de modèle : copiez les ID bruts comme claude-opus-5-5 depuis le tableau des modèles d’APIYI.
  • Facturation du cache : si vous avez besoin du cache, utilisez la compatibilité Anthropic et activez prompt_caching.
  • Ordre de dépannage : vérifiez successivement /v1, le token, l’ID du modèle, puis les paramètres des outils.
  • Pour démarrer : créez un token dédié sur api.apiyi.com/token, la configuration prend 5 minutes.

Résumé

Pour changer de modèle dans Zed, l’essentiel est de confirmer quel niveau vous modifiez :

  1. Changer de modèle pour Zed Agent : dans LLM Providers, utilisez Add Provider pour ajouter un endpoint compatible OpenAI ou compatible Anthropic.
  2. External Agent : Claude Agent, OpenCode, etc. gèrent leur propre authentification, et la clé n’est pas partagée avec Zed Agent.
  3. Base URL : pour la compatibilité OpenAI, renseignez https://api.apiyi.com/v1 ; pour la compatibilité Anthropic, renseignez https://api.apiyi.com — un /v1 en trop ou manquant provoquera une erreur 404.

Avant de configurer, je vous conseille de vérifier les modèles et prix du jour sur docs.apiyi.com/models, puis de créer une clé dédiée à Zed depuis la page des tokens. Commencez par faire fonctionner claude-sonnet-5-5, puis passez à claude-opus-5-5 selon vos tâches. Vous pouvez comparer les résultats avec le même token sous les deux Providers via APIYI apiyi.com.

📚 Références

  1. Dépôt GitHub de Zed : code source et observation du nombre d’étoiles (2026-11-13)
  2. Lien : github.com/zed-industries/zed

  3. Description : la licence est principalement GPL-3.0-or-later, avec des composants Apache-2.0

  4. Zed AI Overview : documentation officielle des trois approches IA

  5. Lien : zed.dev/docs/ai/overview

  6. Description : les frontières entre Zed Agent, External Agents et Terminal Threads

  7. Zed Use API Access : configuration d’un Provider personnalisé

  8. Lien : zed.dev/docs/ai/use-api-access

  9. Description : les champs OpenAI-compatible / Anthropic-compatible et le stockage dans le trousseau

  10. Zed External Agents : agents externes ACP

  11. Lien : zed.dev/docs/ai/external-agents

  12. Description : la façon de brancher Claude Agent, Codex, OpenCode, etc.

  13. Zed Releases : journal des versions

  14. Lien : zed.dev/releases/stable

  15. Description : le contenu de la version stable 1.28.1 et des mises à jour Preview

  16. Tableau récapitulatif des modèles APIYI : ID des modèles et tarifs

  17. Lien : docs.apiyi.com/models.md

  18. Description : prix d’entrée / de sortie / de lecture du cache, à vérifier sur la liste du jour

  19. FAQ sur la configuration du Base URL APIYI : la règle du /v1

  20. Lien : docs.apiyi.com/faq/base-url-config.md

  21. Description : les différences d’écriture du Base URL en mode compatible OpenAI et en mode natif Claude

  22. Page des capacités Claude d’APIYI : endpoints natifs et compatibles

  23. Lien : docs.apiyi.com/api-capabilities/claude.md

  24. Description : la facturation du cache ne s’applique qu’au format Messages

  25. Annonce du lancement de claude-opus-5-5 chez APIYI : limites d’utilisation

  26. Lien : docs.apiyi.com/live/2026-09/claude-opus-5-5.md
  27. Description : explications sur les valeurs par défaut de la réflexion, de tool_choice et de effort

Auteur : l’équipe technique APIYI
Assistance technique : en cas de problème de configuration, consultez le centre de documentation docs.apiyi.com, ou contactez-nous via la page d’accueil du site officiel APIYI

Articles connexes

Publications similaires