Markdown ↗

OHGROK / 接入指南

排查一次请求

先定位失败环节,再决定是否重试。

本页内容

保留排查信息

保留 HTTP 状态、响应体、模型 ID、分组、时间和请求或任务 ID。分享日志前移除 Authorization 等密钥内容;不同上游可能使用不同错误码,要结合消息判断。

常见失败情况

现象检查方向
鉴权失败 / 401本站密钥、Bearer 请求头、密钥是否失效。
权限错误 / 403账户权限、模型分组和允许使用的模型。
参数错误 / 400JSON 格式、准确模型 ID、接口与支持参数。
地址错误 / 404重复 /v1、错误操作路径或不存在的任务。
额度或限流 / 429余额、分组限制及上游限流。
超时 / 5xx重试前检查已保存任务 ID 与控制台处理结果。

有边界地重试

鉴权或参数错误应修正后再提交。临时故障使用有上限的退避,并遵循响应中的 Retry-After(如有)。新的生成 POST 可能产生另一笔计费操作,本接口说明不承诺通用幂等保证。

视频优先查询原任务 ID,终态后停止轮询。流式中断应保留已收到内容,并在应用中明确显示失败。