跳转到主要内容
Poixe Docs home page
简体中文
搜索...
⌘K
Dashboard
Dashboard
搜索...
Navigation
错误处理
上游错误
文档
API 参考
使用场景
帮助支持
API 参考
概览
接口地址
API 密钥
协议兼容
模型命名
错误处理
基本介绍
上游错误
系统错误
非格式化错误
文本接口
OpenAI Chat Completions
OpenAI Responses
Anthropic Messages
Google Gemini Content
在此页面
常见原因
如何识别
处理建议
错误处理
上游错误
上游错误来自模型厂商或其网关。它通常意味着:请求已经被转发到上游,并由上游返回了错误响应。
常见原因
请求参数不符合协议要求(字段缺失、类型错误、取值非法)
鉴权失败(上游 Key/权限问题)
上游限流或过载
上游服务异常或维护
如何识别
查看响应头中的来源标识:
复制
Poixe-Error-Source: upstream
Poixe-Request-Id: <request_id>
同时,上游错误的响应体一般会保持上游协议的原始错误结构(可能因协议不同而不同)。
处理建议
如果是参数错误:优先对照对应协议的文档页检查请求体字段
如果是限流/过载:建议在客户端实现退避重试(并降低并发)
如果是偶发性 5xx:可重试;若持续出现,携带 Request ID 联系团队
基本介绍
系统错误
⌘I