API Base URL 怎么填：根地址、/v1 与完整端点

配置 AI API 时，地址填错一个层级，就可能出现 404、返回网页 HTML，或者请求被发到错误接口。对于 WuDi API 的常用聊天兼容接口，先记住这三个不同的地址：

应填哪一个，取决于客户端怎样追加路径。 不要只看输入框叫“API 地址”就判断，也不要把完整聊天端点填到所有 Base URL 输入框里。

先确认客户端怎样拼接路径

以聊天接口为例，最终请求应落到 https://wudiapi.com/v1/chat/completions。下面的表格演示路径组合，不代表任何具体客户端版本的实测结果。

有的程序会规范化斜杠，有的程序直接拼接字符串。因此，修改后应查看客户端日志中的最终请求 URL，而不只检查设置界面。

出现 /v1/v1 或 404 时怎么检查

先找到实际请求地址，再按以下顺序排查：

1. 检查重复的版本前缀。 如果最终地址是 /v1/v1/chat/completions，说明版本前缀被重复添加。只在一处保留 /v1，不要同时删掉客户端和配置中的前缀。
2. 检查重复的端点。 如果地址包含 /chat/completions/chat/completions，通常是把完整端点填入了会自动追加端点的输入框。
3. 区分 API 响应和网页。 如果返回体是 HTML 页面，先确认请求是否发到了正确路径、使用了正确方法，并检查是否发生了重定向。
4. 核对请求方法。 聊天调用使用 POST；在浏览器地址栏打开一个 URL 发出的通常是 GET。地址栏的结果不能证明聊天请求一定可用或不可用。
5. 核对协议。 客户端需要的如果是其他协议，正确的聊天 Base URL 也不能自动让它兼容。

路径正确后仍然报错，再看认证、模型 ID 和权限。详细顺序见API 常见错误排查。

API Key 和模型 ID 也要与地址对应

使用 WuDi API 时，应填写你在本站创建的 Key。其他平台的 Key、消费会员或账号余额不会自动转成本站调用权限。

模型名称填写当前模型目录中的可调用 ID，注意连字符、大小写和前缀。不要根据品牌名称自行猜测 ID，也不要在切换模型后沿用不受支持的参数。

可用模型还可能受到 Key 的模型限制、分组和额度影响。完整接入步骤见WuDi API 接入文档，当前公开型号见模型广场。

用模型列表请求检查基本连接

如果你在自己的终端中已配置 WUDI_API_KEY 环境变量，可以参考现有文档查询模型列表。以下代码不会替你创建 Key；复制前请确认运行环境。

Linux / macOS 的常见 shell：

curl -i "https://wudiapi.com/v1/models" \
  -H "Authorization: Bearer $WUDI_API_KEY"

Windows PowerShell：

curl.exe -i "https://wudiapi.com/v1/models" -H "Authorization: Bearer $env:WUDI_API_KEY"

不要把终端输出中的授权信息或真实 Key 发到公开讨论区。如果请求失败，保留 HTTP 状态、脱敏错误信息和请求 ID（如有）。

模型列表请求成功，只能帮助确认这一步的连接、认证和模型可见性。它不能证明聊天、流式响应、图片生成或工具调用都已通过测试。下一步应按文档发送一条简短的模型请求，并核对使用记录。

图片和原生接口不要套用同一条聊天路径

/v1/chat/completions 是这里讨论的聊天端点。其他接口可能使用不同路径、请求体和认证细节。配置前应同时确认：

• 客户端实际使用哪种协议；
• 所选模型在本站开放了哪个端点；
• 请求参数是否受支持；
• 当前账户和 Key 是否有对应权限。

只替换 Base URL 并不能解决所有协议差异。遇到具体客户端问题时，反馈客户端名称、版本、最终请求路径和脱敏错误信息，便于区分地址问题与能力限制。

配好地址之后做什么

先查看模型与价格，按接入文档发送短请求，再到使用记录中核对模型、用量和费用。不要在第一条请求尚未跑通时就开启批量任务。

常见问题

Base URL 一定要以 /v1 结尾吗？

不一定。WuDi API 常用基址为 https://wudiapi.com/v1，但某些客户端会自行追加 /v1。以最终请求 URL 和当前客户端说明为准。

用浏览器打开 API 地址报错，是否说明服务不可用？

不能这样判断。API 可能要求特定请求方法、认证头和请求体，浏览器地址栏不能替代真实 API 请求。

模型列表能返回，为什么客户端仍然失败？

模型列表不验证客户端的完整功能。继续核对所用协议、模型参数、额度，以及客户端是否依赖流式、工具或其他能力。

参考：WuDi API 现有文档；Cline 官方对 Base URL、Key 和 Model ID 的配置说明。具体客户端能否使用本站模型，需要按版本与模型组合验证。