运行与排查
定位失败发生在哪一步
保留请求时间、模型、HTTP 状态、脱敏的错误正文和响应请求标识。不要分享完整令牌、Cookie、私有图片链接或敏感提示词。
| 现象 | 先检查 |
|---|---|
| 401 | 令牌是否有效、是否过期或被撤销；Authorization 是否为 Bearer 格式 |
| 403 | 令牌模型权限、分组、余额或上游访问限制；以错误正文为准 |
| 404 / model not found | 完整路径和模型 ID；先 GET /v1/models。不要盲目换成未上架型号 |
| 429 | 额度、并发、速率或上游限制；遵循 Retry-After（如有），退避重试 |
| 400 / 422 | JSON / multipart 格式、必需字段、size、模型与接口是否匹配 |
| 5xx / timeout | 网关、上游或网络异常；先核对使用日志，避免重复提交已执行任务 |
| SSE 200 但没有完整内容 | 检查 error 事件、[DONE] 和最终结束原因，不只检查 HTTP 状态 |
| 图片 URL 失效 / 无法解码 | 查看实际响应类型与下载状态，完整下载后用图片库解码；不是保存 200 正文即算成功 |
最短排查流程
- 用相同令牌调用
GET /v1/models。 - 从本站文档复制最小请求，只替换模型与内容。
- 临时关闭客户端自己的自动重试，记录第一次失败。
- 在控制台查询对应使用记录，判断是否已经结算或仍需等待。
- 向管理员提供账户 ID、时间、模型、状态和可用的请求 ID；不提供密钥。
退避与超时
对明确可重试的瞬时错误使用有上限的指数退避，例如 2、4、8 秒再加随机抖动；最多尝试次数由业务控制。对生图等有成本的请求，未确认是否已执行前不要自动重发。文本与图片设置不同读取超时，SSE 连接需允许长时间读取并正确处理主动取消。
兼容格式不等于全部能力相同
客户端标注“OpenAI 兼容”仍可能不支持图片编辑、SSE 或特定参数。先用文档 cURL 请求区分客户端配置和上游问题。GPT 图片请选择图片生成/编辑接口，Gemini 目前按本文档提供文本与 SSE。
最近更新：2026 年 10 月 24 日 · 参数、价格与可用性以本站当前配置为准。