用途：本技能是 Perplexity Sonar API 常见错误的快速参考，帮助定位报错根因并给出修复方案。前提是已设置 PERPLEXITY_API_KEY 环境变量，且系统中有 curl 可用于诊断。
主要能力与常见错误：
- 401 Unauthorized：API Key 无效，可能缺失、过期、被吊销或前缀不是 pplx-。可检查前缀并直接测试 Key，必要时在 perplexity.ai/settings/api 重新生成。
- 429 Too Many Requests：超出每分钟请求数（多数档位 50 RPM），采用漏桶算法。可用指数退避重试。
- 400 Bad Request：模型名错误，有效模型为 sonar、sonar-pro、sonar-reasoning-pro、sonar-deep-research；或 search_domain_filter 超出 20 个域名上限，或同时混用允许列表与拒绝列表。应二选一，拒绝列表加 - 前缀。
- 空引用数组：并非错误，但常见。抽象或非事实性问题可能无引用，建议使用具体事实查询，sonar-pro 引用数通常更多。
- 超时/请求挂起：复杂查询耗时更长，sonar 约 1-3 秒，sonar-pro 约 3-8 秒，deep research 约 10-60 秒，可设置 AbortController 超时。
- 402 Payment Required：账户额度不足，需在 perplexity.ai/settings/api 充值。
诊断方式：使用 curl 请求 chat/completions 检查 HTTP 状态码，或通过 env | grep PERPLEXITY 检查环境变量，用 dig 测试 DNS。错误处理上，400、401、402 不应重试，应修复参数或账户；429 可指数退避重试；500+ 可在 2-5 秒后重试。
限制：资料未说明各错误的具体收费或价格信息，也未提供完整集成步骤，相关细节暂未提供。