Perplexity AI API 使用指南：实时网络搜索与引用生成，支持 sonar 模型

perplexity by vm0-ai/vm0-skills

81 周安装量

47 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/vm0-ai/vm0-skills --skill perplexity

AI/机器学习 API 搜索

🇨🇳中文介绍

Perplexity AI

提供基于实时网络信息并附有来源引用的 AI 搜索引擎。与传统搜索不同，Perplexity 会综合多个来源的信息，生成连贯的回应。

官方文档：https://docs.perplexity.ai/

使用场景

在以下情况时使用此技能：

获取带有来源引用的实时信息
研究需要最新网络数据的主题
回答需要综合多方信息的复杂问题
进行学术或 SEC 文件研究
获取基于当前网络内容的 AI 生成摘要

前提条件

在 https://perplexity.ai/ 创建账户
访问 API 设置页面：https://perplexity.ai/account/api
生成一个 API 密钥

设置环境变量：

export PERPLEXITY_API_KEY="pplx-your-api-key"

使用方法

1. 聊天补全（推荐）

具备网络搜索和引用功能的 AI 问答。兼容 OpenAI SDK。

使用 sonar 模型进行基本查询：

写入 /tmp/perplexity_request.json：

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

2. 使用域名过滤器搜索

将搜索限制在特定域名。

写入 /tmp/perplexity_request.json：

{
  "model": "sonar",
  "messages": [
    {"role": "user", "content": "Latest research on transformer architectures"}
  ],
  "search_domain_filter": ["arxiv.org", "openai.com", "anthropic.com"]
}

curl -s -X POST "https://api.perplexity.ai/chat/completions" --header "Authorization: Bearer $(printenv PERPLEXITY_API_KEY)" --header "Content-Type: application/json" -d @/tmp/perplexity_request.json

排除域名（添加 - 前缀）：

写入 /tmp/perplexity_request.json：

{
  "model": "sonar",
  "messages": [
    {"role": "user", "content": "Best programming practices"}
  ],
  "search_domain_filter": ["-reddit.com", "-quora.com"]
}

curl -s -X POST "https://api.perplexity.ai/chat/completions" --header "Authorization: Bearer $(printenv PERPLEXITY_API_KEY)" --header "Content-Type: application/json" -d @/tmp/perplexity_request.json

3. 使用时间过滤器搜索

按新近程度过滤。

写入 /tmp/perplexity_request.json：

{
  "model": "sonar",
  "messages": [
    {"role": "user", "content": "Major tech news"}
  ],
  "search_recency_filter": "week"
}

curl -s -X POST "https://api.perplexity.ai/chat/completions" --header "Authorization: Bearer $(printenv PERPLEXITY_API_KEY)" --header "Content-Type: application/json" -d @/tmp/perplexity_request.json

按日期范围过滤：

写入 /tmp/perplexity_request.json：

{
  "model": "sonar",
  "messages": [
    {"role": "user", "content": "AI announcements"}
  ],
  "search_after_date_filter": "12/01/2024",
  "search_before_date_filter": "12/31/2024"
}

curl -s -X POST "https://api.perplexity.ai/chat/completions" --header "Authorization: Bearer $(printenv PERPLEXITY_API_KEY)" --header "Content-Type: application/json" -d @/tmp/perplexity_request.json

搜索学术来源。

写入 /tmp/perplexity_request.json：

{
  "model": "sonar",
  "messages": [
    {"role": "user", "content": "Recent papers on large language model alignment"}
  ],
  "search_mode": "academic"
}

curl -s -X POST "https://api.perplexity.ai/chat/completions" --header "Authorization: Bearer $(printenv PERPLEXITY_API_KEY)" --header "Content-Type: application/json" -d @/tmp/perplexity_request.json

获取未经 AI 综合的原始搜索结果。

写入 /tmp/perplexity_request.json：

{
  "query": "Claude AI Anthropic",
  "max_results": 5
}

curl -s -X POST "https://api.perplexity.ai/search" --header "Authorization: Bearer $(printenv PERPLEXITY_API_KEY)" --header "Content-Type: application/json" -d @/tmp/perplexity_request.json

使用域名和时间过滤器：

写入 /tmp/perplexity_request.json：

{
  "query": "machine learning tutorials",
  "max_results": 10,
  "search_domain_filter": ["github.com", "medium.com"],
  "search_recency_filter": "month",
  "country": "US"
}

curl -s -X POST "https://api.perplexity.ai/search" --header "Authorization: Bearer $(printenv PERPLEXITY_API_KEY)" --header "Content-Type: application/json" -d @/tmp/perplexity_request.json

6. 深度研究（长篇）

用于全面的研究报告。

写入 /tmp/perplexity_request.json：

{
  "model": "sonar-deep-research",
  "messages": [
    {"role": "user", "content": "Write a comprehensive analysis of the electric vehicle market in 2024"}
  ],
  "reasoning_effort": "high"
}

curl -s -X POST "https://api.perplexity.ai/chat/completions" --header "Authorization: Bearer $(printenv PERPLEXITY_API_KEY)" --header "Content-Type: application/json" -d @/tmp/perplexity_request.json

用于复杂问题解决。

写入 /tmp/perplexity_request.json：

{
  "model": "sonar-reasoning-pro",
  "messages": [
    {"role": "user", "content": "Analyze the pros and cons of microservices vs monolithic architecture for a startup"}
  ]
}

curl -s -X POST "https://api.perplexity.ai/chat/completions" --header "Authorization: Bearer $(printenv PERPLEXITY_API_KEY)" --header "Content-Type: application/json" -d @/tmp/perplexity_request.json

模型	描述	最佳用途
`sonar`	轻量级，性价比高	快速事实、新闻、简单问答
`sonar-pro`	高级搜索，理解更深	复杂查询、详细研究
`sonar-reasoning-pro`	带搜索的多步推理	问题解决、分析
`sonar-deep-research`	详尽研究、报告	学术研究、市场分析

聊天补全返回：

{
  "id": "uuid",
  "model": "sonar",
  "choices": [
  {
  "message": {
  "role": "assistant",
  "content": "The answer with [1] citations..."
  }
  }
  ],
  "citations": ["https://source1.com", "https://source2.com"],
  "search_results": [
  {
  "title": "Source Title",
  "url": "https://source.com",
  "snippet": "Relevant excerpt..."
  }
  ],
  "usage": {
  "prompt_tokens": 10,
  "completion_tokens": 150,
  "total_tokens": 160
  }
}

模型选择：简单查询用 sonar，复杂查询用 sonar-pro
成本优化：降低 search_context_size 可减少成本（低/中/高）
域名过滤器：最多限制 20 个域名；使用 - 前缀排除
新近度过滤器：选项为 day、week、month、year
温度：事实性查询用较低值（0.1-0.3），创意性查询用较高值
速率限制：因套餐而异；请查看 https://docs.perplexity.ai/guides/rate-limits-usage-tiers
引用：响应包含编号引用 [1]，映射到 citations 数组

2026 年 1 月 24 日

🇺🇸English

Perplexity AI

AI search engine that provides real-time web-grounded answers with source citations. Unlike traditional search, Perplexity synthesizes information from multiple sources into coherent responses.

Official docs: https://docs.perplexity.ai/

When to Use

Use this skill when you need to:

Get real-time information with source citations
Research topics that require up-to-date web data
Answer complex questions that need multi-source synthesis
Perform academic or SEC filings research
Get AI-generated summaries grounded in current web content

Prerequisites

Create an account at https://perplexity.ai/
Navigate to API settings: https://perplexity.ai/account/api
Generate an API key

Set environment variable:

export PERPLEXITY_API_KEY="pplx-your-api-key"