Perplexity免费版怎么用：每日Pro搜索额度与引用链接说明

接口形态与模型名

Perplexity 的 API 采用与主流对话补全兼容的形态，base_url 为 https://api.perplexity.ai，对话补全路径为 /chat/completions，因此现有的 OpenAI 风格 SDK 大多只需替换 base_url 和 Key 即可跑通。常用模型名为 sonar（偏轻量、速度快）与 sonar-pro（更深的检索与更长回答），完整可用的模型列表请看控制台的模型下拉框或官方文档，不同账号可能看到的名称不完全一致。

先把 Key 放进环境变量

不要在代码里硬编码密钥，先用环境变量保存，再让程序读取。

export PERPLEXITY_API_KEY="粘贴控制台生成的 Key"

一次对话补全调用

下面的 curl 命令是最小可用示例。关键参数：model 指定模型；messages 是消息数组，system 用来约束回答风格，user 放具体问题；temperature 控制发散程度，做事实类问答建议调低；max_tokens 限制回答长度，用来控成本；stream 设为 true 可逐字返回，适合做打字机效果。搜索相关的过滤参数（如时间范围、限定站点）请以官方文档当前字段名为准。

curl https://api.perplexity.ai/chat/completions \
  -H "Authorization: Bearer $PERPLEXITY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sonar",
    "messages": [
      {"role": "system", "content": "只回答有来源支撑的内容，并保留引用编号。"},
      {"role": "user", "content": "列出三家主流向量数据库的免费额度，并说明来源。"}
    ],
    "temperature": 0.2,
    "max_tokens": 800,
    "stream": false
  }'

返回体里除了 choices 中的答案文本，通常还带有引用链接列表；把引用一起渲染到页面上，是这类搜索型模型相对普通对话模型的主要价值。

额度耗尽与限流的典型表现

• 401 未授权：Key 拼错、复制时带了空格，或 Key 已被删除。先检查环境变量是否真的注入到运行进程里。

• 402 或 403 余额不足：预充值额度用完或未绑定支付方式。到控制台的用量与账单页核对，网页版的每日免费搜索次数不会抵扣 API 费用。

• 429 请求过多：触发速率限制。按响应头里的重试提示退避，不要立刻死循环重试；批量任务改成串行加时间间隔。

• 返回空内容或截断：多半是 max_tokens 设得太小，或提示词要求过长，先调大上限再看是否与上下文长度限制冲突。

排查顺序建议固定为：先用 curl 直连验证 Key 与余额，再排查 SDK 的 base_url 与路径拼接，最后才怀疑网络与代理。这样能把问题定位在一层内，避免同时改动多个变量。