疑难排查 · Zed

Zed 中 OpenAI 兼容模型的 api_url——自定义 base URL 与 404

如何用 language_models.openai.api_url 把 Zed 的 OpenAI 提供商指向自定义端点,以及为什么缺少 /v1 或未列出的模型 ID 会导致 404。

你看到的报错

zed custom openai api url

为什么会发生

  • api_url 没有带 /v1。Zed 会在 api_url 后追加 API 路径(例如 /chat/completions),请求于是被发到端点不提供服务的路径。
  • api_url 加在了错误的设置键下或有拼写错误,于是 Zed 悄无声息地继续使用默认端点。
  • 端点正确,但 available_models 中的模型名不是它提供的,这是 404 的另一个来源。

如何解决

  • 把 api_url 设为 https://router.apitoken.sale/v1,让 Zed 自己拼出其余路径。
  • 把该设置准确放在 settings.json 的 language_models.openai.api_url——放错位置的键不会报错,只是什么也不做。
  • 如果 404 响应体里点名了某个模型,说明路径没问题,问题在模型 ID:列出端点的模型并使用它提供的 ID。

正确的 settings.json

{
  "language_models": {
    "openai": {
      "api_url": "https://router.apitoken.sale/v1"
    }
  }
}
// wrong: "api_url": "https://router.apitoken.sale"  → no /v1 in the path → 404

相关搜索

  • zed api_url not working
  • {"error":{"message":"The requested endpoint is not supported.","type":"invalid_request_error","code":"unsupported_endpoint"}}

常见问题

Zed 的 api_url 应该包含 /v1 吗?+
对 OpenAI 提供商要包含:https://router.apitoken.sale/v1。Zed 会自己追加 API 路径;没有 /v1 时该路径不存在,端点返回 404。
怎么知道我的自定义 api_url 真的生效了?+
故意把它改坏一次(填一个无意义的主机)——如果什么都没变,说明 Zed 没读到你改的那个键;去修正设置路径。
路径正确,但还是 404——为什么?+
404 响应体会点名缺少的东西。如果点名的是模型,就选一个端点提供的 ID;通过 GET /v1/models 列出它们。

跳过折腾坏掉的配置

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