三种地址不要混用
| 名称 | OpenAI 兼容场景示例 | 用在哪里 |
|---|---|---|
| 站点根地址 | 从下面 Base URL 去掉末尾 /v1 | 明确要求站点根地址的工具 |
| Base URL | https://top.qingyuntop.ai/v1 | OpenAI SDK 和多数兼容客户端 |
| 完整端点 | https://top.qingyuntop.ai/v1/chat/completions | HTTP 请求、明确要求端点的配置项 |
调用模型列表的完整地址是 https://top.qingyuntop.ai/v1/models。SDK 通常会自动追加端点，不要把 /chat/completions 填到 SDK 的 base_url，再让 SDK 重复拼接。
配置检查
- 核对地址来自本站文档或控制台 API 信息。
- 检查是否错误包含
/dashboard、/admin、localhost或文档页面路径。 - 确保协议和端口正确、没有空格；OpenAI 兼容地址通常只有一个
/v1。 - 先查询模型列表，再发最小生成请求。
不同协议
Anthropic Messages 与 Gemini 原生 SDK 的路径拼接规则与 OpenAI SDK 不完全一致。请按本站对应模型文档填写，不能仅靠修改模型名切换协议。参见兼容性说明。
返回 HTML 而不是 JSON
常见原因是访问了控制台页面、反向代理错误页或登录跳转。查看 HTTP 状态、Content-Type 和最终 URL，修正地址后再检查密钥；不要把 HTML 的解析错误当成模型故障。