modelparams.dev
API MCP GitHub

Providers

Alibaba Anthropic Bedrock Cerebras Cohere DeepSeek Fireworks Google Groq Meta MiniMax Mistral Moonshot AI NVIDIA OpenAI Opencode Go Perplexity Thinking Machines Vertex xAI Xiaomi Z.ai

Providers

Alibaba Anthropic Bedrock Cerebras Cohere DeepSeek Fireworks Google Groq Meta MiniMax Mistral Moonshot AI NVIDIA OpenAI Opencode Go Perplexity Thinking Machines Vertex xAI Xiaomi Z.ai
Perplexity Chat Completions 12 params

Perplexity Sonar Pro API parameters

These are the API parameters modelparams.dev tracks for Perplexity Sonar Pro on Chat Completions with an API key — the settings you send in a request. Each row gives the type, default, valid range or values, and the conditions that gate it. It's the same data the JSON API serves.

After the parameter count instead — how many weights Sonar Pro has? That's a different number, and we don't track it. Here's the difference.

Length 1 param
Parameter Type Default Description Condition
Max tokens
max_tokens 		integer (1…128000) — Maximum number of output tokens the model may generate. —
Sampling 2 params
Parameter Type Default Description Condition
Temperature
temperature 		number (0…2 step 0.1) — Controls randomness. Lower values make outputs more focused; higher values make them more varied. —
Top P
top_p 		number (0…1 step 0.01) — Controls nucleus sampling by limiting generation to tokens within the selected cumulative probability. —
Metadata 9 params
Parameter Type Default Description Condition
Search mode
search_mode 		enum (web | academic | sec) — Selects the corpus the model searches when grounding its answer. —
Search recency filter
search_recency_filter 		enum (hour | day | week | month | year) — Restricts web search results to a recent time window. —
Search domain filter
search_domain_filter 		string — Limits search to, or excludes, specific domains. —
Search after date
search_after_date_filter 		string — Restricts search results to content published after this date (MM/DD/YYYY). —
Search before date
search_before_date_filter 		string — Restricts search results to content published before this date (MM/DD/YYYY). —
Search context size
web_search_options.search_context_size 		enum (low | medium | high) "low" Controls how much web search context is retrieved before generating the answer. —
Return images
return_images 		boolean false Controls whether the response may include related images from the search. —

Perplexity Sonar Pro API parameters in brief

Perplexity Sonar Pro on Chat Completions documents 12 API parameters, grouped by what they control:

Frequently asked questions

Which API parameters does Perplexity Sonar Pro support?
Perplexity Sonar Pro accepts 12 API parameters in the request body: max_tokens, temperature, top_p, search_mode, search_recency_filter, search_domain_filter, and more.

Resources

All Perplexity models Glossary Full catalog

Sonar Pro — JSON

The full model definition as served by the API. Copy it or open the endpoint directly.

/api/v1/models/perplexity/sonar-pro.json 
{
  "$schema": "https://modelparams.dev/api/v1/schema.json",
  "provider": "perplexity",
  "authType": "api_key",
  "apiSurface": "openai-chat-completions",
  "model": "sonar-pro",
  "params": [
    {
      "path": "max_tokens",
      "label": "Max tokens",
      "description": "Maximum number of output tokens the model may generate.",
      "group": "generation_length",
      "type": "integer",
      "range": {
        "min": 1,
        "max": 128000
      }
    },
    {
      "path": "temperature",
      "label": "Temperature",
      "description": "Controls randomness. Lower values make outputs more focused; higher values make them more varied.",
      "group": "sampling",
      "type": "number",
      "range": {
        "min": 0,
        "max": 2,
        "step": 0.1
      }
    },
    {
      "path": "top_p",
      "label": "Top P",
      "description": "Controls nucleus sampling by limiting generation to tokens within the selected cumulative probability.",
      "group": "sampling",
      "type": "number",
      "range": {
        "min": 0,
        "max": 1,
        "step": 0.01
      }
    },
    {
      "path": "search_mode",
      "label": "Search mode",
      "description": "Selects the corpus the model searches when grounding its answer.",
      "group": "provider_metadata",
      "type": "enum",
      "values": [
        "web",
        "academic",
        "sec"
      ]
    },
    {
      "path": "search_recency_filter",
      "label": "Search recency filter",
      "description": "Restricts web search results to a recent time window.",
      "group": "provider_metadata",
      "type": "enum",
      "values": [
        "hour",
        "day",
        "week",
        "month",
        "year"
      ]
    },
    {
      "path": "search_domain_filter",
      "label": "Search domain filter",
      "description": "Limits search to, or excludes, specific domains.",
      "group": "provider_metadata",
      "type": "string"
    },
    {
      "path": "search_after_date_filter",
      "label": "Search after date",
      "description": "Restricts search results to content published after this date (MM/DD/YYYY).",
      "group": "provider_metadata",
      "type": "string"
    },
    {
      "path": "search_before_date_filter",
      "label": "Search before date",
      "description": "Restricts search results to content published before this date (MM/DD/YYYY).",
      "group": "provider_metadata",
      "type": "string"
    },
    {
      "path": "web_search_options.search_context_size",
      "label": "Search context size",
      "description": "Controls how much web search context is retrieved before generating the answer.",
      "group": "provider_metadata",
      "type": "enum",
      "default": "low",
      "values": [
        "low",
        "medium",
        "high"
      ]
    },
    {
      "path": "return_images",
      "label": "Return images",
      "description": "Controls whether the response may include related images from the search.",
      "group": "provider_metadata",
      "type": "boolean",
      "default": false
    },
    {
      "path": "return_related_questions",
      "label": "Return related questions",
      "description": "Controls whether the response includes suggested follow-up questions.",
      "group": "provider_metadata",
      "type": "boolean",
      "default": false
    },
    {
      "path": "disable_search",
      "label": "Disable search",
      "description": "Turns off web search so the model answers from its own knowledge only.",
      "group": "provider_metadata",
      "type": "boolean",
      "default": false
    }
  ]
}

Other Perplexity models

Sonar 12 params View Sonar Deep Research 12 params View Sonar Reasoning Pro 12 params View

How to use

Building with an AI agent? Hit Copy to grab this whole guide as Markdown and paste it in — or point your agent straight at /llms.txt.

modelparams.dev is an open, community-maintained catalog of model parameters. Each entry shows the knobs you can turn — type, default, range, and the conditions that gate it.

The same model accessed via an API key and via a subscription usually exposes a different set of parameters. We list both as separate entries so the data stays honest.

Catalog API

The full catalog is static JSON, CORS-enabled, served from the edge.

curl https://modelparams.dev/api/v1/models.json

Each entry is keyed by provider/model for API-key variants; subscription variants append -subscription.

If you only need the params for one model contract, use the providerless endpoint. Subscription contracts are model slugs with -subscription. 

curl https://modelparams.dev/api/v1/models/openai/gpt-5.5.json
curl https://modelparams.dev/api/v1/models/openai/gpt-5.5-subscription.json

Single model

curl https://modelparams.dev/api/v1/models/anthropic/claude-opus-4-7.json
curl https://modelparams.dev/api/v1/models/anthropic/claude-opus-4-7-subscription.json

JSON Schema

Every entry validates against a JSON Schema you can use in your editor or pipeline. 

curl https://modelparams.dev/api/v1/schema.json

Add this header to any YAML you author for autocomplete in VS Code: 

# yaml-language-server: $schema=https://modelparams.dev/api/v1/schema.json

Logos

Provider logos are available at /assets/logos/{provider}.svg where {provider} is the provider slug. They use currentColor so they inherit your text color. 

curl https://modelparams.dev/assets/logos/anthropic.svg

Logos are sourced from the models.dev repo (MIT) and used under nominative fair use.

Contribute

The data lives in YAML under models/{provider}/{model}-{auth}.yaml in the GitHub repo. Open a PR; CI validates against the schema and rebuilds.

Edit on GitHub MIT licensed