Skip to main content

Authorization

Follow this guide to create a new Perplexity AI credential that will allow Nexla to authenticate to and exchange data with your Perplexity AI account.
perplexity_api_auth.png

Perplexity AI

Prerequisites​

Before creating a Perplexity AI credential, you'll need to obtain an API key from your Perplexity AI account. Perplexity provides API keys for programmatic access to their Chat Completions API through the Perplexity API platform.

To obtain a Perplexity AI API key:

  1. Log in to your Perplexity AI account at https://www.perplexity.ai or navigate to the Perplexity API dashboard.

  2. Navigate to your account settings or API dashboard. This is typically accessible from the user menu or dashboard navigation.

  3. In the API settings or API Keys section, locate the option to create or manage API keys.

  4. Click Create API Key or Generate New Key to create a new API key for your application. You may need to provide a name or description for the API key.

  5. Copy the API key immediately after generation, as it may only be displayed once for security purposes. Store it securely, as you'll need it to authenticate API requests.

Perplexity AI API keys are used as Bearer tokens in the Authorization header for all API requests. The API key is sensitive information and should be kept secure. If you've lost your API key, you'll need to generate a new one in your Perplexity AI account settings.

For detailed information about Perplexity AI API authentication and API key management, refer to the Perplexity AI API Documentation.

Create a Perplexity AI Credential​

  • To create a new Perplexity AI credential, after selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

New Credential Overlay – Perplexity AI

PerplexityCred.png

Credential Name & Description​

  1. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

    Resource descriptions are recommended but are not required. They should be used provide information about the resource purpose, data freshness, etc. that can help the owner and other users efficiently understand and utilize the resource.

Credential Settings​

  1. In the API Key field, enter the API key that you obtained from your Perplexity AI account. This is the secret API key used to authenticate requests to the Perplexity AI API.

  2. In the Base URL field, enter the base URL for the Perplexity AI API. The default value is https://api.perplexity.ai, which is the standard base URL for Perplexity AI API services. You can specify a different base URL if your organization uses a custom endpoint.

  3. In the API Version field (labeled as "Chat completions payload to test a connection"), enter a sample JSON payload to test the connection. A default payload is provided:

    {
      "model": "sonar",
      "messages": [
        {
          "role": "system",
          "content": "Be precise and concise."
        },
        {
          "role": "user",
          "content": "How many stars are there in our galaxy?"
        }
      ]
    }

    The API key is sensitive information and should be kept secure. If you've lost your API key, you'll need to generate a new one in your Perplexity AI account settings. API keys are used as Bearer tokens in the Authorization header for all API requests.

Save the Credential​

  1. Once all of the relevant steps in the above sections have been completed, click the Save button at the bottom of the overlay to save the configured credential.

  2. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation and can be selected for use with a new data source or destination.