错误码

Pixapi 使用 HTTP 状态码加机器可读错误类型。

错误格式

{
  "error": {
    "code": 400,
    "message": "xxx",
    "type": "invalid_request_error"
  }
}

常见错误

HTTP 状态	Type	含义
400	invalid_request_error	请求字段缺失或无效。
401	unauthorized	API Key 缺失或无效。
402	insufficient_credits	账户积分不足。
404	model_not_found	模型 id 不存在或不可用。
422	prompt_rejected	提示词或输入违反模型策略。
429	rate_limited	短时间请求过多。
500	internal_error	服务端异常。
503	model_unavailable	模型供应商暂时不可用。

重试建议

只重试临时性错误：

• 429 rate_limited
• 500 internal_error
• 503 model_unavailable

对 400、401、402 或 422，请先修改请求、密钥或账户状态，不要直接自动重试。