不管用哪个客户端,接入自定义 API 都是同一套逻辑:三个输入框——Base URL、API Key、模型名,加上一个容易忽略的坑:URL 带不带 /v1。这篇把常见客户端的填写方式和报错对照整理在一起。
通用填法
Base URL:OpenAI 兼容接口习惯写 https://你的域名/v1;Anthropic 协议(Claude Code 等)只写到域名根。两种都要以服务方文档为准,写错不会报「地址错」,只会给你 404 或 401。
API Key:中转平台的 key 通常是 sk- 开头,填进客户端的 API Key 字段,不要额外套 Bearer(客户端自己会加)。
模型名:要和平台上的名称完全一致(大小写、后缀都可能不同),复制平台页面上的名字最稳。
报错对照
401:key 错或没带上。404:base_url 层级写错,常见是重复 /v1。model_not_found:模型名不在你所在的渠道分组里——同一平台不同分组的可用模型是不同的。429:并发或余额问题。