Perplexity提供异步API支持耗时任务处理：一、通过/v1/async/task提交任务获取task_id；二、用GET轮询/v1/async/task/{task_id}查状态，按指数退避重试；三、可配置Webhook实现事件驱动回调。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您调用Perplexity API执行耗时任务（如长文本分析、多步推理或外部工具链调度），同步阻塞式等待将显著拖慢整体响应速度。Perplexity通过提供Async接口与配套的状态轮询机制，使客户端可在发起任务后立即释放连接，并按需查询执行进展。以下是实现该能力的具体路径：
一、使用/v1/async/task端点提交异步任务
Perplexity的异步任务入口采用标准REST风格设计，返回轻量级task_id而非完整结果，适用于所有支持异步语义的请求类型（如query、tool_call、data_extraction）。该方式将执行控制权移交服务端调度器，避免客户端长时间空等。
1、构造POST请求至https://api.perplexity.ai/v1/async/task，确保Header中包含Authorization: Bearer <your_api_key></your_api_key>与Content-Type: application/json。
2、在请求体中传入标准prompt字段及可选参数，例如：{"model": "sonar-medium-online", "prompt": "总结这篇论文的核心贡献", "max_tokens": 512}。
3、接收响应中的task_id与status字段（初始值为queued），并记录当前时间戳用于后续轮询间隔控制。
二、通过GET /v1/async/task/{task_id}轮询任务状态
状态轮询是异步模式下获取结果的核心手段，Perplexity服务端保证该端点具备幂等性与最终一致性，且不因重复请求产生额外计费。轮询频率需兼顾时效性与服务负载，建议采用指数退避策略。
1、使用上一步获得的task_id拼接URL，发起GET请求至https://api.perplexity.ai/v1/async/task/<task_id></task_id>。
Perplexity SEO 优化指南 — 如何获得 Perplexity AI 的引用。涵盖 Perplexity 引用行为、面向 Perplexity 答案的内容结构、Perplex...
2、解析响应JSON，检查status字段值：若为completed，则result字段即为最终输出；若为failed或timeout，则error字段提供具体原因。
3、当status为queued或running时，暂停指定毫秒后重试：首次等待200ms，第二次500ms，第三次起每次翻倍直至上限5000ms。
三、配置Webhook回调替代主动轮询
对于高并发或长周期任务场景，主动轮询可能引入不必要的网络开销与客户端资源占用。Perplexity支持注册HTTP Webhook，在任务终态变更时由服务端主动推送事件通知，实现真正的事件驱动响应。
1、在API密钥管理页面进入Webhooks → Register New，填写目标接收地址（需支持HTTPS且响应延迟低于3秒）。
2、勾选事件类型：task_completed、task_failed、task_timeout，确保覆盖全部终态分支。
3、设置Secret Key用于签名验证，Perplexity将在每个回调请求Header中添加X-Perplexity-Signature头，其值为HMAC-SHA256(payload + secret_key)的十六进制编码。
