稳定 AI API 接入：账户调度、错误处理与生产验收

账户调度与有边界的故障恢复

网关按请求的分组和模型选择符合条件的上游账户。在支持的请求路径中，符合条件的上游错误可触发有次数边界的账户切换。调度仍然受模型可用性、账户容量、供应商配额和所选分组限制；账户切换不能把不可用模型变成可用，也不代表所有接口的恢复行为完全相同。

折扣分组和其他服务分组不应视为同一条线路。先查看公开目录，再用准备投入生产的准确模型、分组、参数和并发做验收。如果业务需要应用层备用策略，应明确记录切换条件及请求需求，避免把一条线路的测试结果用于宣传另一条线路。

让失败变成可处理的结果

接入文档列出了鉴权失败、余额不足、速率限制、并发限制和上游容量不足等错误。按当前协议族解析错误信封，服务返回 Retry-After 时遵守等待时间，并对重试次数设限。排查时保存请求标识、模型、时间和错误码；不要通过无限重发掩盖真实失败。

图片与视频采用异步任务流程。轮询到文档定义的完成或失败终态，核对失败码，并在临时下载地址有效期内保存成品。付费任务发生网络超时时，不要直接重复提交：先核对原任务的状态，确认是否已完成、仍在运行或明确失败，再决定下一步。

生产环境应该怎样验收稳定性？

在相同模型、分组、上下文长度和并发下，记录完整响应成功率、首字延迟、完成耗时与实际成本。业务需要流式、工具调用、图片或视频时，要分别验收流完成、工具结果、任务终态和成品下载。把失败请求也纳入样本；单纯的健康端点或 HTTP 200 不能证明客户拿到了可用输出。

从小规模真实业务开始，观察表现再扩大流量。Apixly 提供接入文档和 [email protected] 支持渠道。本页不声称未经公开测量的可用率百分比或合同级 SLA；如果业务有明确合同要求，请结合服务条款或另行书面约定确定保障范围。

常见问题