Register your credit card to get started. This step will not charge your credit card. Rather, it stores payment information for later API usage.
Generate an API key. The API key is a long-lived access token that can be used until it is manually refreshed or deleted.
Send the API key as a bearer token in the Authorization header with each API request.
When you run out of credits, your API keys will be blocked until you add to your credit balance. You can avoid this by configuring "Automatic Top Up", which refreshes your balance whenever you drop below \$2.
Our supported models are listed on the [Supported Models](/api-docs/model-cards) page.
The API is conveniently OpenAI client-compatible for easy integration with existing applications.
```python python
from openai import OpenAI
YOUR_API_KEY = "INSERT API KEY HERE"
messages = [
{
"role": "system",
"content": (
"You are an artificial intelligence assistant and you need to "
"engage in a helpful, detailed, polite conversation with a user."
),
},
{
"role": "user",
"content": (
"How many stars are in the universe?"
),
},
]
client = OpenAI(api_key=YOUR_API_KEY, base_url="https://api.perplexity.ai")
# chat completion without streaming
response = client.chat.completions.create(
model="llama-3.1-sonar-large-128k-online",
messages=messages,
)
print(response)
# chat completion with streaming
response_stream = client.chat.completions.create(
model="llama-3.1-sonar-large-128k-online",
messages=messages,
stream=True,
)
for response in response_stream:
print(response)
```
# Supported Models
## Perplexity Sonar Models
| Model | Parameter Count | Context Length | Model Type |
| ----------------------------------- | --------------- | -------------- | --------------- |
| `llama-3.1-sonar-small-128k-online` | 8B | 127,072 | Chat Completion |
| `llama-3.1-sonar-large-128k-online` | 70B | 127,072 | Chat Completion |
| `llama-3.1-sonar-huge-128k-online` | 405B | 127,072 | Chat Completion |
Our online models are focused on delivering helpful, up-to-date, and factual responses to all your questions