Perplexity

Use Perplexity with Blazen — construct the PerplexityProvider and call complete().

Perplexity is an OpenAI-compatible LLM provider. Construct it like any other Blazen provider — build a list of ChatMessages, call complete() (or stream()), and read back a typed ModelResponse.

At a glance

Provider id	perplexity
Base URL	https://api.perplexity.ai
Default model	sonar-pro
API key env var	PERPLEXITY_API_KEY
Auth	Authorization: Bearer <key>

Set PERPLEXITY_API_KEY in the environment and Blazen reads it automatically, or pass the key explicitly when you construct the provider.

Capabilities

Capability	Supported
Streaming	Yes
Tool calling	No
Structured output	No
Vision	No
Model listing	No
Embeddings	No

Usage

Construct the provider and call complete(). The default model is sonar-pro; override it with with_model / model when you need a different one.

use blazen_llm::{Model, ModelRequest, ChatMessage};
use blazen_provider_perplexity::PerplexityProvider;

// Reads PERPLEXITY_API_KEY from the environment, or pass the key to `new`.
let model = PerplexityProvider::new(std::env::var("PERPLEXITY_API_KEY")?);

let resp = model
    .complete(ModelRequest::new(vec![ChatMessage::user("Hello")]))
    .await?;
println!("{}", resp.content.unwrap_or_default());

from blazen import PerplexityProvider, ProviderOptions, ChatMessage

# Omit the api_key to read PERPLEXITY_API_KEY from the environment.
model = PerplexityProvider(options=ProviderOptions(api_key="..."))

resp = await model.complete([ChatMessage.user("Hello")])
print(resp.content)

import { PerplexityProvider, ChatMessage } from "blazen";

// Omit apiKey to read PERPLEXITY_API_KEY from the environment.
const model = PerplexityProvider.create({ apiKey: "..." });

const resp = await model.complete([ChatMessage.user("Hello")]);
console.log(resp.content);

Streaming

async for chunk in model.stream([ChatMessage.user("Count to five")]):
    print(chunk.delta, end="")

await model.stream([ChatMessage.user("Count to five")], (chunk) => {
  if (chunk.delta) process.stdout.write(chunk.delta);
});

See also

• Models & Providers — the canonical provider + ModelManager guide