疑难排查 · Zed

Zed 401 Invalid API Key——OpenAI 提供商设置修复

Zed 助手会原样透传端点返回的 401。Zed 中 OpenAI 提供商的密钥和 api_url 放在哪里,以及为什么它们必须来自同一签发方。

你看到的报错

HTTP 401
{"error":{"message":"Invalid or missing API key.","type":"invalid_request_error","param":null,"code":"invalid_api_key"}}

为什么会发生

  • Zed 的 OpenAI 提供商设置里的密钥和 api_url 指向不同的签发方——把网关密钥发往默认的 api.openai.com,或者反过来。
  • 密钥粘贴时带了空白或被截断。
  • 启动 Zed 的环境里设有其他提供商的 OPENAI_API_KEY 环境变量,Zed 发送的是它而不是你预期的密钥。
  • 密钥已被吊销或已过期。

如何解决

  • 把 language_models.openai.api_url 设为 https://router.apitoken.sale/v1,并在助手的 OpenAI 提供商设置中填入该签发方的密钥。
  • 让 api_url 以 /v1 结尾——Zed 会自己追加 API 路径。
  • 在改动其他任何东西之前,先用 curl 验证这一对。

适用于本网关的 Zed settings.json

{
  "language_models": {
    "openai": {
      "api_url": "https://router.apitoken.sale/v1",
      "available_models": [{ "name": "gpt-6.1-terra", "display_name": "GPT-6.1 Terra", "max_tokens": 872000 }]
    }
  }
}

相关搜索

  • zed openai api key not working
  • zed 401 unauthorized

常见问题

Zed 把 OpenAI 的 base URL 放在哪里?+
在 settings.json 的 language_models.openai.api_url 下。API 密钥本身在助手的提供商配置中填写。
为什么我的密钥在 Zed 里不行,在 curl 里却能用?+
Zed 会把它发往配置的 api_url。如果它与你 curl 的 URL 不同,看到密钥的端点就不是签发它的那个。
在 Zed 里使用 GPT 模型需要 OpenAI 账号吗?+
不需要——任何 OpenAI 兼容端点都可以:把 api_url 设为签发方地址,使用它的密钥,并在 available_models 中列出模型。

跳过折腾坏掉的配置

apiToken.sale 通过 OpenAI 兼容端点、Messages(Anthropic 格式)端点和原生 Gemini 端点提供 GPT 与 Gemini 模型——标准 SDK、一把密钥、一个预付余额。把你工具的 base URL 指向它,本页的配置即可原样生效。