提供方类型
选择 OpenAI 或 OpenAI-compatible，不使用 Anthropic 类型填写同一套地址。
先把三个关键变量分开
同一个错误可能由不同层级触发。按地址、认证、模型或并发逐层验证，比同时修改所有配置更容易定位原因。
API 地址
填写 https://api.linktoagi.com/v1，不添加 /chat/completions。
模型列表
手动添加或同步控制台中的实际模型名，注意大小写和后缀。
三步完成最小验证
保留一个可复现的短请求，每次只修改一个变量，并记录返回状态。
新增自定义提供方
进入模型服务设置，新增 OpenAI-compatible 提供方并命名为 LinkAGI。
填写地址与 Key
API 地址填 /v1，API Key 使用控制台创建的独立令牌。
添加模型并测试
复制实时模型名，先执行连通性检查，再创建一段短对话。
Cherry Studio 字段对应关系
提供方名称：LinkAGI
提供方类型：OpenAI-compatible
API 地址：https://api.linktoagi.com/v1
API Key：sk-从控制台创建
模型：从实时模型广场复制API Key 只放在环境变量或客户端密钥字段中，不要写进公开仓库、截图或前端代码。模型名与价格请从 LinkAGI 实时模型广场复制。
结果出现后，下一步看什么
不要把所有失败都归因到“中转站不稳定”。先判断请求停在路径、认证、模型、速率还是超时层。
连通性检查失败
确认地址为 HTTPS、没有空格、没有重复 /v1，并重新复制完整 Key。
模型列表为空
部分自定义提供方需要手动添加模型；以 LinkAGI 实时模型广场为准。
返回 model not found
检查模型名、令牌分组和当前模型状态，不要沿用已下线的旧名称。
能对话但扣费不明
打开控制台使用日志，按时间核对该次请求的 Token 与实际费用。
LinkAGI 场景
使用 api.linktoagi.com 接入后，可以在控制台调用日志中核对模型、Token、状态和扣费；遇到持续异常可携带时间与请求信息联系支持，但不要发送完整 API Key。
常见问题
API 地址后面需要写 /chat/completions 吗？
不需要。Cherry Studio 会根据请求自动拼接具体路径。
可以直接使用控制台账号密码吗？
不可以。客户端只填写从令牌管理创建的 API Key。
为什么模型名称必须从控制台复制？
模型版本和后缀可能变化，手写旧名称容易导致 model not found。
继续排查相关问题
OpenAI API 中转站
OpenAI API 国内接入：Base URL、Key 与首次请求一次配置
如果现有代码已经使用 OpenAI SDK，迁移到 LinkAGI 通常只需要替换 Base URL 与 API Key。真正容易出错的不是代码主体，而是地址层级、模型名和密钥分组。
OpenAI API 429 Rate LimitAPI 返回 429：不要立刻无限重试，先判断限制发生在哪一层
429 可能来自客户端令牌限额、账户余额、模型并发、当前号池或上游速率限制。相同状态码不等于相同原因，正确做法是保留请求时间与日志，再做有限退避。
AI API 504 Gateway TimeoutAI API 返回 504：上游没坏，也可能卡在首字节和代理超时
504 表示某一层网关没有在规定时间内拿到下游响应。上游控制台显示正常，并不能排除单请求首字节过慢、边缘代理超时、非流式长任务或客户端提前断开。
先用短请求验证 LinkAGI
注册赠送 ¥0.2 试用额度；模型、号池和价格以实时页面为准。