modelparams.dev

Perplexity Sonar Reasoning Pro parameters

These are the parameters modelparams.dev tracks for Perplexity Sonar Reasoning Pro. 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.

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 Reasoning Pro API parameters in brief

Perplexity Sonar Reasoning Pro documents 12 API parameters, grouped by what they control:

Frequently asked questions

How many parameters does Perplexity Sonar Reasoning Pro accept?
Perplexity Sonar Reasoning Pro accepts 12 API parameters: max_tokens, temperature, top_p, search_mode, search_recency_filter, search_domain_filter, and more.

Resources

All Perplexity models Glossary Full catalog

Sonar Reasoning Pro — JSON

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

{
  "$schema": "https://modelparams.dev/api/v1/schema.json",
  "provider": "perplexity",
  "authType": "api_key",
  "model": "sonar-reasoning-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

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/params/gpt-5.5.json
curl https://modelparams.dev/api/v1/params/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