Create an agent response using the Perplexity Agent API (POST /v1/agent). Supports multi-step agentic reasoning with web search, URL fetching, and custom function tools. Either model, models, or preset must be provided.

Chat completions with live web grounding using Perplexity Sonar models (POST /v1/sonar). Supports domain filters, recency filters, and location-aware search.

Submit an asynchronous deep research job (POST /v1/async/sonar). Returns a request_id to poll with sonar_async_get. Ideal for sonar-deep-research model.

Get the status or result of an async Sonar job (GET /v1/async/sonar/{request_id}).

List all async Sonar jobs (GET /v1/async/sonar).

Perform a raw web search returning full page content (POST /search). Returns structured result objects with URL, title, and text content. Supports up to 5 parallel queries, domain filters, date filters, and specialized academic/SEC modes.

Generate dense vector embeddings for one or more text strings (POST /v1/embeddings). Use for semantic search, similarity comparison, or retrieval-augmented generation (RAG). Returns vectors in base64 format.

Generate context-aware embeddings for document chunks (POST /v1/contextualizedembeddings). Unlike standard embeddings, each chunk's vector is influenced by surrounding chunks in the same document, producing better representations for RAG. Input is an array of arrays: each inner array is a document's chunks.

Generate a new Perplexity API key (POST /generate_auth_token). Returns the new auth_token, creation timestamp, and optional token_name. Note: This uses the PERPLEXITY_API_KEY set in your environment to authenticate.

Revoke an existing Perplexity API key (POST /revoke_auth_token). The revoked key will immediately stop working. This action is irreversible.

Rotate the current API key: generates a new key, verifies it works by making a test request, then revokes the old key. Returns the new key and rotation status. IMPORTANT: Save the new key immediately — it will not be shown again.

Estimate the USD cost of a request before sending it. Returns a breakdown by input tokens, output tokens, and tool invocations.

List all available Perplexity models with descriptions, context lengths, and current pricing. Prices are in USD per million tokens.

Test API connectivity and verify the configured PERPLEXITY_API_KEY is valid and working. Makes a minimal test request to the Sonar API.