Zed

Zed API URL 填写错误如何解决

API URL 是 Zed 调用 AI Code With 的根地址。官方 OpenAI-compatible 流程要求填写 https://api.aicodewith.ai/v1。Zed 会在该地址后自行拼接 chat completions 路径;你既不能去掉 /v1,也不能自己追加 /chat/completions。

先做这几项判断

API URL 填错路径、漏了 /v1,或改的是内置 OpenAI 而不是 openai_compatible。

  • 发送消息失败、超时,或提示接口路径错误、404、连接被拒绝。
  • API URL 漏填 /v1,或写成了 https://api.aicodewith.ai
  • 打开 Agent Settings → LLM Providers,确认选中的是 OpenAI-compatible 的 AI Code With 条目
404ECONNREFUSEDtimeout

01

确认改的是 openai_compatible,而不是内置 OpenAI

正确做法是:Add Provider → OpenAI-compatible,然后只改这个新条目的 API URL。错误做法是把 language_models.openai.api_url 改成中转地址——这会覆盖 Zed 内置 OpenAI,请求仍可能走官方 OpenAI 鉴权,或出现路径混乱。

在 Agent Settings 的 LLM Providers 列表里,应能看到一个独立的自定义 Provider(名称如 AI Code With / aicodewith)。如果列表里只有 OpenAI、Anthropic 等内置项,说明还没有添加 openai_compatible。

02

填写不含多余路径的 /v1 地址

唯一正确的值是 https://api.aicodewith.ai/v1。常见错误包括:漏掉 /v1、写成 /v1/chat/completions、末尾多一个 /、或误用其他文档里的旧域名。

Zed 会把你填写的 API URL 当作 OpenAI 兼容根路径。填 https://api.aicodewith.ai 时,后续拼接会变成缺少 /v1 的错误地址;填带 /chat/completions 的完整 URL 时,则会变成重复路径。两种都会导致失败或 404。

  1. 1打开 Agent Settings → LLM Providers,确认选中的是 OpenAI-compatible 的 AI Code With 条目
  2. 2把 API URL 改为 https://api.aicodewith.ai/v1(必须含 /v1,后面不要再跟路径)

03

保存后用真实请求验证

保存 Provider,回到 Agent 面板选择该 Provider 下的模型并发送消息。超时或 DNS 错误时,再检查本机是否能访问 api.aicodewith.ai。

验证成功的标准是模型返回正常回复,并且 AI Code With 用量记录里能按时间找到这次调用。如果回复正常但用量没有记录,说明请求没有打到 AI Code With,应改看「请求没走 AI Code With」。

  1. 1把 API URL 改为 https://api.aicodewith.ai/v1(必须含 /v1,后面不要再跟路径)
  2. 2不要编辑 language_models.openai.api_url;如已改过,恢复官方值并改用 openai_compatible

不要把第三方中转教程里的其他域名(例如 yibuapi.com)填进 Zed。本页只使用 https://api.aicodewith.ai/v1。

仍没解决时,继续看

资料来源

重新配置

返回接入中心,继续处理对应的配置步骤。

回到相关配置步骤