需先订阅Perplexity Pro计划，再在Settings→API Keys中创建sk-prod-开头的密钥，最后通过Bearer认证调用https://api.perplexity.ai/chat/completions接口。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望使用Perplexity Pro版API进行开发，但尚未获取API Key或不清楚如何调用其接口，则可能是由于官方访问路径不明确或认证流程未完成。以下是获取Perplexity Pro版API Key并完成接口调用的完整操作步骤：
一、注册并开通Perplexity Pro订阅
Perplexity Pro版API Key仅对已订阅Pro计划的用户开放，免费账户无法生成有效密钥。您必须先完成身份验证与付费订阅，才能进入API管理页面。
1、访问 https://www.perplexity.ai/ 并点击右上角“Log In”按钮，使用邮箱或Google账号登录。
2、登录后点击右上角头像，选择“Upgrade to Pro”，按提示完成Stripe付款流程。
3、订阅成功后，等待页面自动跳转至仪表盘，确认账户状态显示为“Pro Active”。
二、进入API设置页并创建Key
API Key在Pro账户专属的安全设置区域生成，每个Key可绑定名称与权限范围，且支持随时禁用或重置，保障调用安全性。
1、在左侧导航栏点击“Settings”，再选择子菜单中的“API Keys”。
2、点击页面中央的“Create new API key”按钮。
3、在弹出窗口中输入描述性名称（如“my-web-app-v1”），勾选所需权限（建议初始仅选“Read & Query”），然后点击“Confirm”。
4、新生成的Key将以sk-prod-开头的32位字符串形式显示，立即复制并安全存储——该Key**仅显示一次**，刷新后不可见。
三、配置请求头并调用基础问答接口
Perplexity Pro API采用标准REST风格，所有请求必须携带Authorization头，且Content-Type需设为application/json，否则返回401错误。
1、打开终端或Postman，新建POST请求，目标URL为：https://api.perplexity.ai/chat/completions。
2、在Headers中添加两项：Authorization: Bearer sk-prod-xxx... 与 Content-Type: application/json。
3、在Body → raw → JSON中填入最小必要参数：
{
"model": "sonar-medium-online",
"messages": [
{"role": "user", "content": "解释量子纠缠"}
]
}
四、使用cURL命令行快速验证
cURL是无需额外工具即可验证API连通性的轻量方式，适用于Linux/macOS终端及Windows PowerShell，适合快速调试。
1、在终端中粘贴以下完整命令（将YOUR_API_KEY替换为实际Key）：
curl -X POST https://api.perplexity.ai/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"sonar-medium-online","messages":[{"role":"user","content":"列出Python处理JSON的三个内置模块"}]}'
2、执行后若返回包含“choices”字段的JSON响应，且response.message.content非空，则表明API调用已成功。
五、处理常见HTTP错误响应
当API返回非200状态码时，需根据具体错误码定位问题根源，而非重复提交请求。每类错误对应唯一修复路径。
1、收到401 Unauthorized：检查Header中Authorization值是否拼写错误、是否遗漏Bearer前缀、或Key是否已过期失效。
2、收到429 Too Many Requests：确认当前Pro套餐的RPM（每分钟请求数）配额，默认为60 RPM，超限需等待60秒后再试。
3、收到400 Bad Request：校验JSON Body中model字段是否拼写为sonar-medium-online、sonar-small-online或sonar-pro-online之一，不支持gpt-或claude-前缀模型名。
