Perplexity

At a glance

Set these per environment. See Connect an integration.

Variable	Required	Description
`PERPLEXITY_API_KEY`	Yes	Perplexity API key (starts with pplx-) Docs.

Create a Perplexity account: Go to https://www.perplexity.ai and sign up or sign in, then open the API section of your account settings.
Add billing: Add a payment method and credits in the API portal - API calls require a positive credit balance (Pro subscribers receive monthly API credits).
Generate an API key: In https://www.perplexity.ai/account/api/keys, click ‘Generate’ and copy the key. Add it to your .env file as PERPLEXITY_API_KEY=pplx-…
Verify access: Run the Search Web tool with a simple query. A 401 means the key is invalid; a 402 means you are out of credits.

Sonar chat completions and agent responses are billed per token plus per-request search fees - they cost money on every call
The Search API is billed per request and returns ranked results without LLM generation

Tool	Access	Description
Search Web	Read	Search the web with Perplexity’s Search API and get ranked results
Create Chat Completion	Write	Generate a web-grounded chat completion with citations using a Sonar model
Create Agent Response	Write	Generate a response with Perplexity’s Agent API using optional web search and reasoning

Use Perplexity to research a topic I provide and summarize the answer with its citations.
Search the web with Perplexity for a query I provide and list the top results.