AI 客户端接入配置总览

不管用哪个客户端,接入自定义 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 层级写错,常见是重复 /v1model_not_found:模型名不在你所在的渠道分组里——同一平台不同分组的可用模型是不同的。429:并发或余额问题。

本系列文章

相关资源:模型价格表 · 接入配置教程 · 调用排行榜