Perplexity (Sonar)
Lets an agent ask web-grounded questions and get answers with live citations, run long research jobs asynchronously, and run raw web searches via Perplexity Sonar.
What it can do
| Method | What it does |
|---|---|
perplexity_chat_completion | Ask a web-grounded question and get an answer with citations - pick a Sonar model and optional search/recency/domain filters. |
perplexity_create_async_chat_completion | Submit a long-running question (e.g. deep research) to run asynchronously; returns a request_id. |
perplexity_get_async_chat_completion | Get the status and result of an async chat completion by request_id. |
perplexity_list_async_chat_completions | List the user's async chat completion jobs, with optional paging. |
perplexity_search | Run a raw web search and get a structured list of results (title, url, snippet) with no prose answer. |
perplexity_embeddings | Generate text embeddings for semantic search / RAG from one or more strings (pplx-embed-v1 models). |
perplexity_contextualized_embeddings | Generate chunk-level embeddings that share document-level context for RAG over chunked documents (pplx-embed-context-v1 models). |
perplexity_create_agent_response | Run an agentic workflow on Perplexity's managed runtime (retrieval, tool execution, reasoning) with web_search / fetch_url tools. |
How to get credentials
- Open perplexity.ai/settings/api.
- Add a payment method or buy API credits (the API is pay-as-you-go).
- Click Generate (or Create Key) to create a new API key.
- Copy the
pplx-…key.
Fields to fill in FlyMyAI
| FlyMyAI field | Where it comes from |
|---|---|
PERPLEXITY_API_KEY | Settings → API → Generate key (pplx-…) |
Troubleshooting
401 Unauthorized- the key is wrong or revoked. Generate a new one in the API settings.402/ credit errors - the account is out of API credits. Top up in the API settings.
Links
We love our partners - FlyMy.AI builds with the best. Thanks, Perplexity!