Configuration de l'API personnalisée de Zed Editor

Zed prend en charge à la fois son interface utilisateur Paramètres d'agent et settings.json pour les points de terminaison OpenAI-compatible. Laissez Zed stocker la clé TokenHub API dans le trousseau système ou fournissez-la via la variable d'environnement dérivée du nom du fournisseur. Ne placez pas la clé dans settings.json.

Ajouter un fournisseur dans les paramètres de l'agent

1. Ouvrez la palette de commandes et exécutez agent: open settings.
2. Accédez à Settings → AI → LLM Providers.
3. Cliquez sur Add Provider et choisissez un fournisseur OpenAI-compatible.
4. Entrez tokenhub comme nom de fournisseur.
5. Entrez https://us-api.tokenhub.com/v1 comme API URL.
6. Entrez l'ID de modèle exact indiqué dans le catalogue de modèles TokenHub.
7. Entrez dans la fenêtre contextuelle réelle de ce modèle.
8. Entrez votre clé TokenHub API dans les paramètres du fournisseur afin que Zed la stocke dans le trousseau du système.

Modifiez settings.json lorsque vous avez besoin de plusieurs modèles

Zed prend en charge les fournisseurs sous language_models.openai_compatible. Dans ce schéma, max_tokens désigne la fenêtre contextuelle et non la sortie maximale. Remplacez les deux limites par les valeurs documentées pour votre modèle :

{
  "language_models": {
    "openai_compatible": {
      "tokenhub": {
        "api_url": "__API_BASE_URL__/v1",
        "available_models": [
          {
            "name": "YOUR_TOKENHUB_MODEL_ID",
            "display_name": "TokenHub / YOUR_TOKENHUB_MODEL_ID",
            "max_tokens": 128000,
            "max_output_tokens": 8192,
            "capabilities": {
              "tools": true,
              "images": false,
              "parallel_tool_calls": false,
              "prompt_cache_key": false,
              "chat_completions": true,
              "interleaved_reasoning": false,
              "max_tokens_parameter": false
            }
          }
        ]
      }
    }
  }
}

Si capabilities est omis, Zed utilise les valeurs par défaut de OpenAI-compatible indiquées ci-dessus. Définissez images, parallel_tool_calls ou une autre fonctionnalité sur true uniquement lorsque le modèle et le point de terminaison TokenHub la prennent réellement en charge.

Suivez la règle de recherche de clé API de Zed.

Zed convertit l'ID du fournisseur en majuscules et ajoute _API_KEY. L'ID du fournisseur tokenhub correspond donc à :

export TOKENHUB_API_KEY="sk-..."

Une variable d'environnement non vide est prioritaire sur le trousseau. Si vous avez mis à jour la clé dans l'interface utilisateur mais que Zed envoie toujours un ancien identifiant, supprimez cette variable et redémarrez Zed.

Ne pas déduire la prise en charge du raisonnement ou des réponses à partir d'un nom de modèle

• Lorsqu'un modèle TokenHub prend en charge reasoning_effort de style OpenAI, définissez uniquement une valeur acceptée par le point de terminaison. Zed expose none, minimal, low, medium, high, xhigh et max, mais un point de terminaison tiers peut prendre en charge moins de valeurs.
• TokenHub recommande actuellement les complétions de chat pour cette connexion, alors conservez capabilities.chat_completions: true.
• Remplacez-le par false uniquement pour un modèle qui nécessite les réponses API. Ne changez pas d’API simplement pour permettre le raisonnement.
• Définissez max_tokens_parameter: true uniquement lorsque le point de terminaison nécessite max_tokens au lieu de max_completion_tokens.

Vérifiez à l'intérieur de Zed

Sélectionnez TokenHub / YOUR_TOKENHUB_MODEL_ID dans Agent ou Inline Assistant et demandez-lui d'expliquer le fichier actuel. Si le modèle est absent, vérifiez le JSON, l'ID du fournisseur et le available_models. Pour un 401, vérifiez le TOKENHUB_API_KEY visible par le processus Zed. Si les outils ou les images échouent, revenez à capabilities et assurez-vous que la déclaration ne dépasse pas le support réel du modèle.

Référence officielle

• Zed : Utiliser l'accès API