用途：Perplexity API 用于构建具备实时联网检索与有依据回答的 AI 应用，适合需要最新网络数据、带来源引用、可核验的实时问答，以及结合网络上下文的文档与图片分析。
主要能力：提供 Chat Completions 与 Search API，支持流式响应、多轮对话、结构化输出（JSON Schema）、Pro Search 多步研究、图片与文件附件、返回图片、域名/语言/时间/地区筛选、多查询搜索、异步操作与后台任务、推理强度控制及沙箱工具。模型档位包括 sonar、sonar-pro、sonar-reasoning-pro、sonar-deep-research。
安装与认证：pip install perplexityai 或 npm install @perplexityai/perplexity。设置环境变量，macOS/Linux 用 export PERPLEXITY_API_KEY="your_api_key_here"，Windows 用 setx PERPLEXITY_API_KEY "your_api_key_here"，SDK 会自动读取该变量。
使用方式：Python 中 from perplexity import Perplexity 创建客户端，调用 client.chat.completions.create(model=..., messages=[...]) 或 client.search.create(query=..., max_results=5)。支持 stream=True 流式输出，response_format 指定 json_schema，web_search_options 与 search_domain_filter 等参数控制检索范围。
限制与注意：Pro Search 必须配合 stream=True；不要在提示中索要链接，应使用 citations 字段；不支持递归 JSON Schema，结构化输出中不要用 dict[str, Any]；域名筛选不能混用允许与拒绝列表；多查询搜索不超过 5 条；新 JSON Schema 首次请求可能有 10-30 秒预热；sonar-deep-research 不支持图片；文件 base64 不加 data: 前缀。收费为 Search API 每千次请求 5 美元，Sonar 模型按每百万 token 计费，另有按搜索上下文大小变化的每千次请求费用。