指南
AI API 通用错误码与排障指南
直接答案401/403 检查密钥类型、scope、模型权限和 IP 限制;429 检查额度和限流;5xx 保存非敏感请求编号。HTTP 200 仍可能包含业务错误。超时不证明任务未创建,先查询记录再决定是否重试。
更新 · 审核信息
适用范围
401/403 检查密钥类型、scope、模型权限和 IP 限制;429 检查额度和限流;5xx 保存非敏感请求编号。HTTP 200 仍可能包含业务错误。超时不证明任务未创建,先查询记录再决定是否重试。
选择接口与模型
模型广场展示精确型号、端点、用户组及价格。型号名称相似不代表参数和权限相同;上游官方资料用于了解能力边界,不能作为本站已上架或已计费的证明。完整示例与路由参考分别标注,请优先使用包含结果校验的接入示例。
账号与请求准备
在令牌页管理模型调用 Key,在个人设置管理账号访问凭据。不要把浏览器登录令牌、模型 Key 和个人访问令牌混用。示例从服务端环境变量读取占位凭据,不包含真实账号数据。请求参数必须按所选端点和渠道核实,示例值不是默认值。Base URL 为 https://api.openfox.vip。
结果与失败处理
同时检查 HTTP 状态与业务结果。文本必须有完整输出;图片需要真实解码;任务必须达到成功终态并拿到有效产物,任务 ID 本身不等于完成。查询可以有界重试,创建请求不要自动重试。超时时先保留请求编号,并到用量日志核对,避免重复创建或收费。
价格与后续维护
本文不写死费用、额度、保存期限或供应商折扣。请以模型广场当前价格及账号组权限为准;需要新价格或未上架型号时由管理员确认。接口示例与 OpenFox OpenAPI 定义同步生成,修改协议时同步检查请求字段、结果判定和失败路径。源码核对不代表上游业务验证,本次没有发起收费模型请求。
适用场景
- 排查首次调用失败
- 设计生产重试、熔断与降级
- 向平台支持提供可定位证据
API 协议
/api/log/self/v1/images/generations/result/v1/tasks/{task_id}
常见问题
从哪里确认模型和价格?
以本站模型广场当前型号、端点与用户组价格为准。
可以直接套用其他站点的接口吗?
不可以。必须核对本站路由、插件协议与鉴权要求。
源码核对是否等于业务测试通过?
不是。本次没有发起收费调用,上游可用性仍受渠道和权限影响。
关联指南
官方来源
- OpenAI Error Codes 官方
- OpenAI Rate Limits 官方
- Claude API Errors 官方
- Gemini API Errors 官方
- Gemini API Troubleshooting 官方
- DeepSeek Error Codes 官方
- 阿里云百炼错误码 官方
- Kimi API 错误说明 官方
- 智谱 API 错误码 官方
- 百度千帆错误码 官方
- 腾讯混元错误码 官方
- Amazon Bedrock API 错误排查 官方
- Azure OpenAI 配额与 429 官方
- Cloudflare Workers AI Errors 官方
- Mistral Error Glossary 官方
- OpenFox API 官方