TensorOcean Global 文档

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 或第三方工具的配置问题,从使用指南选择对应教程。

本页目录