地址与客户端选择

不同客户端对“地址”字段的处理方式不完全相同。先看字段语义，再决定是否填写 /v1，不要机械复制。

三种地址规则

场景	填写地址	说明
OpenAI Compatible Base URL	https://duckmans.com/v1	普通 OpenAI 兼容客户端的默认值
ChatBox 的 API Host	https://duckmans.com	ChatBox 另有 API Path 时，由路径字段填写 /v1/chat/completions
Claude / Anthropic 前缀	https://duckmans.com	仅用于支持 Anthropic 协议且 Key 分组可用的客户端
Cherry Studio 的自定义 OpenAI“API 地址”	https://duckmans.com	当前自定义服务商字段会补全 OpenAI 版本路径

避免重复路径

最终请求不应出现 https://duckmans.com/v1/v1/...。如果报 404，先检查客户端是否已经自动追加 /v1 或完整接口路径。

先按字段语义选择分支，再检查客户端最终拼出的请求地址；不要只看字段名称中的 Host 或 Base URL 就机械复制。

客户端速查

客户端	类型或协议	地址	详细教程
ChatBox 电脑端	OpenAI 兼容（Host + Path）	Host https://duckmans.com，Path /v1/chat/completions	查看
ChatBox 手机端	OpenAI 兼容（Host + Path）	Host https://duckmans.com，Path /v1/chat/completions	查看
Cherry Studio	自定义 OpenAI	https://duckmans.com	查看
酒馆（SillyTavern）	Custom OpenAI-compatible	https://duckmans.com/v1	查看
OpenClaw	Custom Provider / OpenAI 兼容	https://duckmans.com/v1	查看
Codex CLI	OpenAI 兼容 Provider	https://duckmans.com/v1	查看
ChatGPT 桌面端（Codex）	OpenAI 兼容 Provider	https://duckmans.com/v1	查看
OpenCode / Kilo Code	OpenAI 兼容 Provider	https://duckmans.com/v1	OpenCode / Kilo Code
Claude Code	Anthropic 兼容	https://duckmans.com	查看

这张图只帮助选择文档入口，不表示列出的客户端支持所有协议或 DuckMans 的全部模型；具体能力以客户端当前版本、Key 分组和模型列表为准。

字段名称怎么判断

填 https://duckmans.com/v1

字段明确写着以下名称，并且说明不会自动追加版本路径时：

• Base URL
• API Host
• OpenAI Compatible URL
• OpenAI API Base

填 https://duckmans.com

• Claude / Anthropic 客户端要求填写 API 前缀时。
• ChatBox 分开提供 API Host 与 API Path 时：Host 填主站地址，Path 填 /v1/chat/completions。
• Cherry Studio 当前自定义 OpenAI 服务商的 API 地址 字段。

ChatBox 是特殊情况

ChatBox 官方配置把 apiHost 与 apiPath 分开，默认路径是 /v1/chat/completions。不要把普通客户端的 Base URL https://duckmans.com/v1 直接照搬到 ChatBox 的 Host 字段；否则可能与 Path 再次拼接版本路径。

不要填写完整接口路径

客户端只要求 Base URL 时，不要填写：

https://duckmans.com/v1/chat/completions

客户端会自行拼接接口路径。完整路径通常只用于 curl 等直接 HTTP 请求。

其他必填项

字段	内容
API Key / Token	YOUR_API_KEY
Model / Model ID	后台当前可用模型 ID
Provider Name	DuckMans

如果模型列表为空，不要复制别处的模型名。先核对 Key 分组、地址和额度，再重新获取列表。