---
title: "Draft Zed integration"
description: "Unverified draft settings for using Zed with minirouter."
canonical_url: "https://minirouter.sh/integrations/zed"
markdown_url: "https://minirouter.sh/integrations/zed.md"
last_updated: "2026-08-04"
---

# Zed + minirouter

Verification status: UNVERIFIED DRAFT
Confirm the current client fields and run the verification request before relying on this configuration.

Draft OpenAI-compatible provider block for Zed's settings.json.

Base URL: https://api.minirouter.sh/v1
Get a key: https://minirouter.sh/key

## Settings

settings.json (cmd-,) → language_models

1. language_models → openai_compatible: minirouter
   The provider entry name — paste the block below.
2. api_url: https://api.minirouter.sh/v1
3. API Key: mr-live-… (your key)
   Entered once in the Agent panel's provider settings, not in settings.json.

## Draft configuration

settings.json — unverified draft

```
{
  "language_models": {
    "openai_compatible": {
      "minirouter": {
        "api_url": "https://api.minirouter.sh/v1",
        "available_models": [
          {
            "name": "meta/llama-3.3-70b",
            "display_name": "Llama 3.3 70B (minirouter)",
            "max_tokens": 131072
          },
          {
            "name": "deepseek/deepseek-v3",
            "display_name": "DeepSeek V3 (minirouter)",
            "max_tokens": 163840
          },
          {
            "name": "mistral/devstral-small-2",
            "display_name": "Devstral Small 2 (minirouter)",
            "max_tokens": 262144
          }
        ]
      }
    }
  }
}
```

## Recommended models

Only use a model after confirming it appears in the live model catalog at https://minirouter.sh/api/v1/models.

- meta/llama-3.3-70b: General-purpose candidate for agent-panel edits.
- deepseek/deepseek-v3: Reasoning-oriented candidate for larger changes.
- mistral/devstral-small-2: Coding-oriented candidate for inline assistance.

## Troubleshooting

### Provider appears but requests fail instantly

The API key is set in the Agent panel's provider settings, not in settings.json — Zed keeps credentials out of the config file.

### 404, HTML, or a parse error on every request

Almost always the base URL. Use https://api.minirouter.sh/v1 — the bare host without /v1 also works, but never append /chat/completions to the base URL field; the client adds that path itself.

Error reference: https://minirouter.sh/docs/errors#invalid_request

### 401 on every request

Wrong or rotated key. Keys start with mr-live-; after a rotation the old key keeps working for 24 hours, then dies.

Error reference: https://minirouter.sh/docs/errors#invalid_api_key

### 402 before any tokens arrive

Balance below the estimated cost of the request. Top up ($5 minimum) — and watch the x-minirouter-balance-usd header, the low-balance signal every response carries.

Error reference: https://minirouter.sh/docs/errors#insufficient_credits
