疑难排查 · 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 列出它们。