跳到正文
alpharouter

开发文档

错误处理

错误分为两类:网关判定后拦截的,以及服务商返回的。通过响应中的 error.source 区分。

错误码表

StatuscodeMeaning
400invalid_requestMalformed body or unknown parameter
401invalid_api_keyMissing, revoked or malformed key
403policy_blockedOrganization policy, key scope or IP rule
402budget_exceededKey budget or balance exhausted
404model_not_foundUnknown model or route path
409idempotency_conflictKey reused with a different body
429rate_limitedProvider or gateway throttling
502provider_errorUpstream provider failed
504provider_timeoutUpstream provider timed out

重试

只对 429 与 5xx 重试。建议采用指数退避并加入抖动,且限制为最多 3 次。400 与 403 重试也会得到相同结果。

幂等性

若存在重复发送同一请求的风险,请加入 Idempotency-Key 请求头。24 小时内使用相同密钥的请求会直接返回首次响应且不再计费。