API 故障排查
按错误现象检查地址、密钥、额度、模型和流式请求。
先保留错误说明,然后用首个请求的一条短文本重试验证。排查时关闭工具、图片和自动重试,避免复杂请求掩盖原因或重复消耗。
从错误现象开始
| 现象 | 先做什么 |
|---|---|
401、缺少密钥或认证失败 | 检查变量是否为空、Key 是否过期或被删除;按密钥与地址核对认证头 |
403、不允许调用或额度不足 | 确认个人/商用服务和账户权限,检查可用 Credit 或钱包余额;钱包余额不能替代个人 Credit |
404 或路径不存在 | 检查 Base URL 是否误填完整端点,路径是否重复 /v1/v1 |
| 模型不存在或不支持接口 | 重新复制模型 ID,检查当前工作空间和协议,移除可选参数后验证 |
HTTP 200 却没有回复 | 查看响应体的 error,再核对当前协议的回复字段;收到 JSON 不等于调用成功 |
| 限流或并发限制 | 降低并行数,停止循环重试,遵循返回的等待提示并使用有限退避重试 |
| 连接失败或超时 | 检查 DNS、代理和网络;核对请求是否已留下记录,再决定是否重试 |
| 调用完成但没有用量记录 | 确认个人/商用入口和时间筛选;记录与结算可能稍后更新 |
不同上游可能使用不同状态和错误格式,应结合响应中的错误说明判断,不能只按状态码分类。
只有流式失败
先设置 stream: false。普通请求成功时,再检查客户端是否支持 SSE、代理是否缓存响应,以及是否使用了正确的协议事件。应用需要捕获 SDK 异常、流内错误和提前断开;部分输出不应标记为完整结果。结束条件与重试限制见流式输出与工具调用。
SDK 提示环境变量不存在
在运行程序的同一个终端重新设置环境变量。Chat 示例需要 TENSOROCEAN_API_ORIGIN、TENSOROCEAN_API_KEY 和 TENSOROCEAN_CHAT_MODEL;只有使用其他协议时才需要相应模型变量。不要在日志中输出密钥来检查它。
仍未解决
通过帮助与支持提供发生时间及其时区、服务类型、模型 ID、接口、客户端版本、脱敏请求、完整错误说明和已有的请求标识。费用问题附调用记录或订单号。删除认证头、API Key、个人资料和敏感提示内容后再分享。
桌面 App 或第三方工具的配置问题,从使用指南选择对应教程。