Set up Perplexity
Researched from Perplexity's official documentation on 2026-11-02. Not yet walked through end to end.
- Current: Choose your API project
Sign in to the Perplexity API Console using the official guide and select the project your application will use.
- Not started: Create a project API key
Open the console’s API Keys page, create an application key and store it privately on your machine.
- Not started: Choose a compatible text model
Review project billing and select a model supported by Prism’s text provider. This verification is a short text request, not the separate deep research workflow.
- Not started: Configure your .env
Use the environment names below in your own application. Keep its environment file out of source control. Never paste a key into this website.
- Not started: Run the local check
Choose a model you can use and run the matching example below on your own machine. Check any applicable usage charges first.
This provider is available in PHP Prism. The TypeScript and Python ports do not implement it.
Configure and verify locally
Environment names and defaults below come from the installed package. Choose a model you can use by setting PRISM_SETUP_MODEL on your machine. Run the verification only when you are ready for one billed request. No request is sent by this page.
Approximate text cost is input tokens × your model’s input rate, plus at most 32 output tokens × its output rate, divided by the rate’s token unit. Add any provider fees. Check your model and region’s current price; the token limit is not a money cap.
use Prism\Prism\Facades\Prism;
// Run in your own configured Laravel app (for example, php artisan tinker).
$model = getenv('PRISM_SETUP_MODEL');
if (!$model) {
throw new RuntimeException('Set PRISM_SETUP_MODEL to your model.');
}
try {
$result = Prism::text()
->using('perplexity', $model)
->withPrompt('Say hello.')
->withMaxTokens(32)
->asText();
echo $result->text, PHP_EOL;
} catch (Throwable $error) {
echo get_class($error), PHP_EOL;
}