连接模型服务商

AI Reader 使用你在设置里选中的服务商。能用哪些模型、怎么计费，都由你的服务商账号决定。浏览和搜索文件不需要这个连接。

添加服务商

打开设置 → 模型，点加号添加服务，再把新建的配置选为当前服务。名称起一个自己认得出的就行，比如“团队网关”。名称只是个标签，不影响使用哪种 API。

然后填写：

字段	填什么
API 类型	服务实际使用的协议：OpenAI Chat Completions、OpenAI Responses 或 Anthropic Messages
端点	服务地址，包括网关要求的路径前缀
认证方式 / API Key	你的 API Key，或该服务商提供的账号登录
模型	账号能用的准确模型 ID

API Key 只在设置里填写，不要贴到对话或项目文件里。有些服务商支持账号登录、不需要 Key；如果支持，在登录方式里选择即可。

端点要和 API 类型对上

模型名称看不出协议：同一个网关可能通过不同的 API 提供名字相近的模型。请按服务文档选择 API 类型，并保留必要的路径前缀。

下面的地址只用来演示 Yenpo 怎么拼接请求 URL，不是真实可用的服务：

API 类型	端点示例	实际请求 URL
Chat Completions	https://gateway.example/v1	https://gateway.example/v1/chat/completions
Responses	https://gateway.example	https://gateway.example/v1/responses
Messages	https://gateway.example	https://gateway.example/v1/messages

如果端点已经以 /chat/completions、/responses 或 /messages 结尾，Yenpo 会原样用于对应的 API 类型。Responses 和 Messages 遇到以 /v1 结尾的端点，会补上最后一段路径。Chat Completions 则总是在你填的地址后面直接加 /chat/completions，不会帮你补上缺失的 /v1。

遇到报错时，别靠来回切换 API 类型碰运气。先弄清服务支持哪种协议、完整的请求路径应该是什么。

模型 ID

可以直接在模型里输入 ID；服务提供模型列表的话，也可以点获取列表。拉取列表和调用模型是两个不同的请求，列表拉不下来时，模型本身可能照样能用，直接填文档里的 ID 试试。

上下文长度会影响 Yenpo 的输入和输出预算，以及何时压缩对话、压缩后保留多少上下文。填写所用模型公布的窗口上限；留空时使用 Yenpo 的默认值。填得太小可能造成不必要的压缩，太大可能让请求超出模型实际能接收的范围。

单价用于计算运行详情中显示的估算费用，按服务商公布的价格填写。它不会改变服务商的实际收费，也不会授予模型访问权限。第一次连通之前，其他模型参数先别动。

每个服务商的图片输入默认关闭。只有模型和 API 都支持你要发送的图片时，再打开支持图片。

用一个小问题测试

打开一个允许发给这个服务的小文件，问：

输入为空时，这个函数返回什么？请引用对应的分支。

能收到回答，说明连接没问题。回答对不对是另一回事，要回到代码里核对。

请求里除了你的消息，还会带上 AI Reader 从项目里找到的相关代码，不只是你输入的文字。往远程端点发送保密代码之前，请先读数据去向、编辑权限与终端。

请求失败时

现象	检查方向
认证或权限错误	当前账号或 Key、端点属于哪个服务、模型权限
找不到资源或 API 不支持	API 类型、完整请求路径、网关前缀
找不到模型	模型 ID 是否准确，账号能否使用
拉取模型失败	服务是否提供模型列表；改为直接填写文档中的模型 ID
超时或流式响应中断	网络、代理或网关、服务是否可用

只凭一个 HTTP 状态码很难判断原因，网关也可能改写上游返回的错误。反馈问题时，请附上报错信息、API 类型和隐去私密部分的端点地址，不要附带 API Key。

如果中断的是一次允许编辑的运行，重试之前先检查项目里的改动。即使没收到最终回答，文件也可能已经被改过。