Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
OpenPAI 返回的 HTTP 状态、错误结构与处理建议
{
"error": {
"message": "Incorrect API key provided.",
"type": "invalid_request_error",
"param": null,
"code": "invalid_api_key"
}
}
| 字段 | 含义 |
|---|---|
message | 人类可读的错误描述,可直接展示给开发者 |
type | 错误类别:invalid_request_error / authentication_error / billing_error / rate_limit_error / server_error |
param | 出错的字段名(若适用) |
code | 机器可识别的错误码 |
| code | 说明 |
|---|---|
invalid_request_error | 请求体格式错误 / 缺少必填字段 |
invalid_model | 模型 ID 不存在或不在令牌白名单 |
context_length_exceeded | 输入 + 输出 token 超过模型上下文窗口 |
unsupported_modality | 该模型不支持图片 / 音频 / 视频输入 |
| code | 说明 |
|---|---|
invalid_api_key | API Key 不存在 / 已删除 / 格式错误 |
expired_api_key | 令牌已过期 |
disabled_api_key | 令牌已被禁用 |
| code | 说明 |
|---|---|
insufficient_quota | 账户或令牌额度耗尽 |
ip_not_allowed | 来源 IP 不在白名单 |
model_not_allowed | 该令牌没有此模型权限 |
| code | 说明 |
|---|---|
model_not_found | 模型不存在(已下线 / 拼写错误) |
resource_not_found | 资源(任务、文件)不存在 |
| code | 说明 |
|---|---|
rate_limit_exceeded | 触发 RPM / TPM 限流 |
concurrent_limit_exceeded | 并发数超过分组上限 |
upstream_rate_limited | 上游厂商返回 429 |
Retry-After(秒),建议使用指数退避重试。
| code | 说明 |
|---|---|
server_error | 网关内部错误,通常自动重试 |
upstream_unavailable | 全部上游通道均不可用 |
upstream_timeout | 上游超时 |
bad_gateway | 上游返回非法响应 |
data: {"error":{"message":"Upstream timeout","type":"server_error","code":"upstream_timeout"}}
data: [DONE]
error 字段,而不仅是 HTTP 状态码。
from openai import OpenAI
import time
client = OpenAI(api_key="sk-...", base_url="https://openp.ai/v1")
def call_with_retry(**kwargs):
delay = 1
for attempt in range(5):
try:
return client.chat.completions.create(**kwargs)
except openai.RateLimitError:
time.sleep(delay)
delay = min(delay * 2, 30)
except openai.APIError as e:
if e.status_code >= 500:
time.sleep(delay)
delay = min(delay * 2, 30)
else:
raise
raise RuntimeError("max retries exceeded")
X-OpenPAI-Request-Id。