Perplexity
Perplexity (search) is available as a provider in Qorven. Add your API key once; rotate across keys automatically on rate-limits.
At a glance
| Category | openai-compat |
| API base | https://api.perplexity.ai |
| Key env var | PERPLEXITY_API_KEY |
| Provider type | OpenAI-compatible |
Setup
Add the key in Qorven
Settings → Provider Keys → Add provider → Perplexity (search) → paste key → Save.The key is AES-256-GCM encrypted with your install’s encryption key before it hits the database.
Mark a default model
Models Hub → Models → pick which Perplexity (search) model is the default for new Qors.
Popular models
The full model list is in the models catalog. Qorven’s catalog keeps costs + context windows + capability flags up to date weekly from the providers.
Rate limits & failover
Qorven supports multiple keys per provider. When one rate-limits, the next is tried automatically. When all keys on a provider are exhausted, failover moves to the next provider in your priority list. Failover →Common issues
401 Invalid key
401 Invalid key
Key is wrong, expired, or from the wrong org. Test with
qorven providers verify perplexity.429 Rate-limited
429 Rate-limited
Provider is throttling. Add another key, or lower your Qor’s model to a less-busy tier. Failover handles this automatically if configured.
402 Insufficient balance
402 Insufficient balance
Usually a missed top-up. Check the provider’s billing dashboard. Qorven will fail over to the next provider; flag loudly if all are exhausted.
Timeout
Timeout
Check your
QORVEN_OUTBOUND_TIMEOUT (default 120s). Some local models need more. For Perplexity (search) specifically: check your network egress allows the provider’s domain.Logo displayed under nominative fair use. See trademarks & attribution for owner, source library, and removal requests.
Related
Provider keys
Full key management UI + CLI.
Models overview
Catalog, defaults, cost.
Failover
Multi-key, multi-provider rotation.
qorven providers CLI
Scripted provider management.