> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enconvo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Perplexity

> Configure Perplexity search-augmented models in EnConvo

## Overview

Perplexity offers unique AI models that combine language understanding with real-time web search. Every response is grounded in up-to-date information from the internet, making Perplexity ideal for research, fact-checking, and questions that require current knowledge.

## Supported Models

| Model                   | Description                 | Best For                            |
| ----------------------- | --------------------------- | ----------------------------------- |
| **sonar-pro**           | Most capable, online search | In-depth research, complex queries  |
| **sonar**               | Fast, online search         | Quick fact-checking, current events |
| **sonar-reasoning-pro** | Reasoning with search       | Complex analysis with citations     |
| **sonar-reasoning**     | Fast reasoning with search  | Quick analysis with sources         |

<Tip>
  All Perplexity models include built-in web search -- responses automatically cite real-time sources from the internet.
</Tip>

## Setup

<Steps>
  <Step title="Get API Key">
    1. Go to [Perplexity API Settings](https://www.perplexity.ai/settings/api)
    2. Sign in or create a Perplexity account
    3. Navigate to the **API** section
    4. Generate a new API key
  </Step>

  <Step title="Configure in EnConvo">
    1. Open **Settings** → **AI Provider**
    2. Select **Perplexity**
    3. Go to **Credentials** module
    4. Enter your API key
  </Step>

  <Step title="Select Model">
    Choose your preferred model from the dropdown
  </Step>
</Steps>

## Configuration

| Setting         | Description           | Default    |
| --------------- | --------------------- | ---------- |
| **Credentials** | API key configuration | Required   |
| **Model Name**  | Model to use          | sonar-pro  |
| **Temperature** | Creativity (0-2)      | Medium (1) |

## Validate and Use

<Steps>
  <Step title="Validate credentials">
    Click **Validate** in the Perplexity credential settings. If validation fails, confirm the API key is active and your API credit balance is available.
  </Step>

  <Step title="Use for current information">
    Choose Perplexity when the answer should be grounded in recent web sources, news, or cited research.
  </Step>

  <Step title="Ask source-aware prompts">
    Ask for dates, sources, and concise summaries when you need verifiable answers.
  </Step>
</Steps>

## Pricing

Check [Perplexity API Pricing](https://docs.perplexity.ai/guides/pricing) for current rates.

| Model               | Input  | Output  |
| ------------------- | ------ | ------- |
| sonar-pro           | \$3/1M | \$15/1M |
| sonar               | \$1/1M | \$1/1M  |
| sonar-reasoning-pro | \$2/1M | \$8/1M  |
| sonar-reasoning     | \$1/1M | \$5/1M  |

<Note>
  Perplexity API credits are separate from a Perplexity Pro subscription. You need to add API credits in your settings.
</Note>

## Best Practices

<AccordionGroup>
  <Accordion title="Model Selection">
    * **sonar-pro**: Detailed research, multi-step questions, comprehensive answers
    * **sonar**: Quick lookups, simple factual questions, news updates
    * **sonar-reasoning-pro**: Complex analysis requiring both reasoning and real-time data
    * **sonar-reasoning**: Quick analytical tasks with source citations
  </Accordion>

  <Accordion title="When to Use Perplexity">
    * Questions about current events, recent news, or time-sensitive information
    * Fact-checking claims with real sources
    * Research tasks that need up-to-date data
    * Any query where you want cited, verifiable answers
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Invalid API key">
    * Verify the key is copied correctly from [perplexity.ai/settings/api](https://www.perplexity.ai/settings/api)
    * Check if your API credit balance is sufficient
    * Ensure the key has not been revoked
  </Accordion>

  <Accordion title="Rate limits">
    * API rate limits depend on your plan
    * Add more API credits if your balance is low
    * Use the lighter `sonar` model for high-volume tasks
  </Accordion>

  <Accordion title="Outdated information">
    * Perplexity searches the web in real-time, but results depend on available sources
    * Rephrase your query to be more specific if results seem incomplete
  </Accordion>
</AccordionGroup>