连接问题排查
请按顺序检查,每次只修改一项设置。
1. 检查 API Key
- 删除前后空格。
- 确认 Key 已启用、未过期且有剩余额度。
- 确认进程可以读取设置的环境变量。
- 不要在日志或支持消息中粘贴完整 Key。
2. 检查协议和 URL
404 经常由客户端重复添加 /v1 或 Endpoint 导致。
3. 检查模型
- 从模型页面复制准确模型 ID。
- 确认 Key 有权限使用该模型。
- 确认模型支持当前协议和功能。
- 如果工具无法加载模型列表,请手动填写模型 ID。
4. 常见状态码
5. 最小化测试
先关闭 Tool、文件、图片、长上下文、JSON Mode 和自定义推理设置,只发送一条短文本。成功后再逐项恢复高级功能。
安全求助
请提供工具与版本、协议、模型 ID、脱敏后的 Base URL 配置、HTTP 状态码、错误文本、Request ID,以及包含时区的时间。不要提供完整 API Key。
