应配置重试逻辑与超时参数提升稳定性：一、全局设置retrypolicy与timeout；二、单次请求动态覆盖；三、自定义http客户端注入网络级重试；四、基于异常类型条件化重试。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 Perplexity API 的 SDK 进行调用时遭遇网络波动导致请求失败，可通过配置重试逻辑与超时参数提升调用稳定性。以下是实现该目标的多种具体方式：
一、通过客户端构建器全局设置 RetryPolicy 与 Timeout
Perplexity 官方 SDK（基于 AWS SDK for Java 2.x 架构）支持在客户端初始化阶段统一注入重试策略与超时参数，适用于所有后续 API 调用。该方式避免重复配置，确保一致性。
1、创建自定义 RetryPolicy 实例，指定最大重试次数为3次，并启用指数退避策略。
2、使用 Duration.ofSeconds(15) 设置单次尝试超时（apiCallAttemptTimeout），防止慢请求阻塞线程。
3、使用 Duration.ofSeconds(45) 设置整体调用超时（apiCallTimeout），覆盖全部重试耗时。
4、将上述策略与超时参数一同传入 ClientOverrideConfiguration.builder()，并绑定至 PerplexityClient.builder()。
二、为单次请求动态覆盖 Retry 与 Timeout 参数
当特定查询对延迟或可靠性有差异化要求时，可在 execute() 或 send() 方法调用时，通过 overrideConfiguration() 临时注入独立的重试与超时策略，不影响其他请求。
1、构造一个仅作用于本次调用的 ClientOverrideConfiguration，内含 apiCallAttemptTimeout(Duration.ofSeconds(8))。
2、在该配置中嵌入 RetryPolicy.builder().numRetries(1).build()，限制仅重试1次。
3、调用 queryWithParameters() 方法时，将该 overrideConfiguration 作为参数显式传入。
4、确认返回结果前未触发超时或达到重试上限，否则抛出 SdkException 子类异常。
通过 Perplexity API 进行深度搜索。提供三种模式：搜索（快速事实）、推理（复杂分析）、研究（深度报告）。返回基于 AI 且有据可依的答案。
三、使用自定义 HTTP 客户端注入底层网络级重试
SDK 底层依赖 Apache HttpClient 或 Netty，可通过替换默认 HTTP 客户端，在传输层添加连接级重试机制，弥补 SDK 级重试无法覆盖的场景（如 DNS 解析失败、TCP 握手超时）。
1、初始化 ApacheHttpClient.builder()，调用 maxConnections(100) 与 connectionTimeToLive(30, TimeUnit.SECONDS) 提升连接复用率。
2、启用 retryPolicy(RetryPolicy.NO_RETRY_POLICY) 关闭 HTTP 层自动重试，防止与 SDK 层重试叠加造成语义混乱。
3、将定制后的 ApacheHttpClient 实例传入 PerplexityClient.builder().httpClient()。
4、验证请求日志中是否出现 ConnectionClosedException 后自动重建连接的行为。
四、基于异常类型实现条件化重试逻辑
并非所有异常都适合重试。通过捕获特定异常并手动触发重试，可规避因客户端错误（如 400 Bad Request）引发的无效重试，提升资源利用率。
1、在 try-catch 块中捕获 SdkServiceException，检查其 statusCode() 是否为 502、503 或 504。
2、若匹配，则使用 Thread.sleep(200L) 执行固定间隔退避，并递归调用同一请求方法（最多2次）。
3、若异常为 SdkClientException 且 cause 是 SocketTimeoutException，则判定为网络瞬断，立即重试。
4、对任何 statusCode ≥ 400 且 ≠ 5xx 的响应，直接抛出不重试，终止流程。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
