接入常见问题

Base URL 末尾要不要加 /v1？

建议加上。 大多数客户端和 SDK 加了 /v1 都能正常使用。

如果加了 /v1 后无法使用，去掉再试——极少数客户端会自动拼接该路径，手动添加会导致重复。

填了 Key 但是提示未授权？

按以下顺序排查：

1. 检查 Key 是否正确：复制时注意前后不要有多余空格或换行
2. 检查 Key 状态：登录主站确认 Key 未被禁用，且账户有余额
3. 检查 Base URL：确认域名和路径填写正确，参考 使用 Key
4. 检查客户端配置：部分客户端的 API Key 字段和 Base URL 字段容易搞混

连接超时？

1. 检查网络：确认你的网络能访问外网
2. 换线路：如果使用站点直连超时，切换到 香港中转节点 或 Cloudflare 节点
3. 用流式模式：非流式请求在长回复时容易超时，改用 "stream": true 可以避免
4. 检查代理设置：如果你使用了网络代理，确认代理没有拦截或干扰 HTTPS 请求