开发文档
错误处理
错误分为两类:网关判定后拦截的,以及服务商返回的。通过响应中的 error.source 区分。
错误码表
| Status | code | Meaning |
|---|---|---|
| 400 | invalid_request | Malformed body or unknown parameter |
| 401 | invalid_api_key | Missing, revoked or malformed key |
| 403 | policy_blocked | Organization policy, key scope or IP rule |
| 402 | budget_exceeded | Key budget or balance exhausted |
| 404 | model_not_found | Unknown model or route path |
| 409 | idempotency_conflict | Key reused with a different body |
| 429 | rate_limited | Provider or gateway throttling |
| 502 | provider_error | Upstream provider failed |
| 504 | provider_timeout | Upstream provider timed out |
重试
只对 429 与 5xx 重试。建议采用指数退避并加入抖动,且限制为最多 3 次。400 与 403 重试也会得到相同结果。
幂等性
若存在重复发送同一请求的风险,请加入 Idempotency-Key 请求头。24 小时内使用相同密钥的请求会直接返回首次响应且不再计费。