如何设置备用模型，实现Perplexity API维护期间无缝切换逻辑？

本文共计907个文字，预计阅读时间需要4分钟。

如果调用Perplexity API时收到模型正在维护中提示，说明当前请求的路由指向的后端模型服务处于临时不可用状态。这种情况常见于Opus或Sonar系列模型的滚动升级、负载均衡或区域节点调度切换等操作。以下是多种独立部署的备用模型切换逻辑实现路径：

一、在请求头中动态注入备用模型标识

Perplexity API支持通过请求体中的model字段显式指定替代模型，当主模型返回503或包含maintenance字样响应时，客户端可立即重试并替换为已验证可用的低延迟模型，无需修改业务主流程。

1、捕获原始API响应状态码与body文本，使用正则匹配"maintenance|under maintenance|temporarily unavailable"。

2、若匹配成功，从预设白名单中选取备用模型名，例如将"sonar-medium-online"替换为"sonar-small-online"或"llama-3.1-70b"。

3、重新构造POST请求体，确保model字段值更新，且保留原有message数组、temperature、max_tokens等参数不变。

4、在HTTP头部添加X-Perplexity-Fallback: true标识，便于后端日志归因。

二、基于OpenAPI规范预置双模型路由策略

利用Perplexity官方OpenAPI v3文档中定义的/model endpoint能力，在客户端初始化阶段主动探测各模型的实时可用性，并构建本地路由映射表，实现毫秒级故障转移。

1、在应用启动时，向https://api.perplexity.ai/models发起GET请求，获取当前全部在线模型列表及status字段。