跳转到主要内容
Hostlinku网关的所有错误都采用相同的_envelope_格式,无论其来源是验证、身份验证、计费还是上游服务故障:
  • status:响应失败时总是显示"error"。
  • error.code:机器代码(稳定,可用于代码中的逻辑分支)。
  • error.message:人类信息,能说印尼语。
  • error.details:可选;例如,在验证失败时显示各字段的详细信息。

错误代码列表

验证详情 (422)

当验证失败时,details.issues 会按字段列出问题清单:

流式传输错误

发生在 SSE 流中间的故障将作为事件数据发送到同一流中(而非作为 HTTP 状态):
网关在发生错误事件后不会发送 data: [DONE],因此断开的流始终可以与正常结束的流区分开来。

处理代码中的错误

处理各类错误的方法:
  • 401:API密钥错误或已过期。请修正配置;请勿反复重试。
  • 402:充值余额或提高/重置 API 密钥限额。请参阅 计费与余额。
  • 422:修复请求正文;请参阅 details.issues 以了解问题所在。
  • 429:采用指数退避,并遵守速率限制标头。请参阅使用与限制。
  • 5xx(UPSTREAM_ERROR、PROVIDER_UNAVAILABLE、INTERNAL):经过多次退避重试;Hostlinku在放弃前已尝试多次。
使用 OpenAI SDK 捕获错误的示例(Python):