Provider: Perplexity

Use Respan Gateway to call Perplexity models (sonar, sonar-pro, sonar-reasoning, sonar-reasoning-pro) while keeping unified observability (logs, cost, latency, reliability) in Respan.

Quick setup

Send your first request

Pick the integration that matches your stack. The base URL is https://api.respan.ai/api and the only key needed is your RESPAN_API_KEY.

1
from openai import OpenAI
2
3
client = OpenAI(
4
    api_key="YOUR_RESPAN_API_KEY",
5
    base_url="https://api.respan.ai/api",
6
)
7
8
response = client.chat.completions.create(
9
    model="perplexity/sonar-pro",
10
    messages=[{"role": "user", "content": "Hello, Perplexity!"}],
11
)
12
print(response.choices[0].message.content)

More integrations

Perplexity models work with every Respan gateway integration:

• OpenAI SDK
• OpenAI Agents SDK
• LangChain
• LangGraph
• LlamaIndex
• Pydantic AI
• Respan native (OTel)

Switch models

Change the model parameter to call any supported model through the same client. Use the perplexity/ prefix to disambiguate when routing across providers. Browse the full list on the Models page.

1
client.chat.completions.create(model="perplexity/sonar", messages=messages)
2
client.chat.completions.create(model="perplexity/sonar-pro", messages=messages)
3
client.chat.completions.create(model="perplexity/sonar-reasoning-pro", messages=messages)
4
client.chat.completions.create(model="openai/gpt-5.5", messages=messages)
5
client.chat.completions.create(model="anthropic/claude-sonnet-4-5", messages=messages)

Use your own Perplexity key (BYOK)

Credits are the default path. If you’d rather bill Perplexity directly, attach your own provider key.

Override credentials per model (Optional)

Use credential_override when one model on a request should use a different Perplexity key than the default.

1
{
2
  "customer_credentials": {
3
    "perplexity": { "api_key": "YOUR_PERPLEXITY_API_KEY" }
4
  },
5
  "credential_override": {
6
    "perplexity/sonar-pro": { "api_key": "ANOTHER_PERPLEXITY_API_KEY" }
7
  }
8
}

Log without proxying (Optional)

Already calling Perplexity directly? Send logs to Respan asynchronously to track cost, latency, and performance for those external calls.

1
import requests
2
3
requests.post(
4
    "https://api.respan.ai/api/request-logs/create/",
5
    headers={
6
        "Authorization": "Bearer YOUR_RESPAN_API_KEY",
7
        "Content-Type": "application/json",
8
    },
9
    json={
10
        "model": "perplexity/sonar-pro",
11
        "prompt_messages": [{"role": "user", "content": "Hello, how are you?"}],
12
        "completion_message": {"role": "assistant", "content": "Hello from Perplexity through Respan."},
13
        "cost": 0.001,
14
        "generation_time": 1.2,
15
        "customer_params": {"customer_identifier": "user_123"},
16
    },
17
)

See the logging guide for the full setup.