Sonar

Reference example

# Fixed reference example. Playground inputs do not update this sample.
curl --request POST \
  --url https://api.aisa.one/apis/v1/perplexity/sonar \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "sonar",
  "messages": [
    {
      "role": "user",
      "content": "What are the latest developments in quantum computing?"
    }
  ]
}'

curl --request POST \
  --url https://api.aisa.one/apis/v1/perplexity/sonar \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "messages": [
    {
      "content": "What are the latest developments in quantum computing?",
      "role": "user"
    }
  ],
  "model": "sonar"
}
'

import requests

url = "https://api.aisa.one/apis/v1/perplexity/sonar"

payload = {
    "messages": [
        {
            "content": "What are the latest developments in quantum computing?",
            "role": "user"
        }
    ],
    "model": "sonar"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    messages: [
      {
        content: 'What are the latest developments in quantum computing?',
        role: 'user'
      }
    ],
    model: 'sonar'
  })
};

fetch('https://api.aisa.one/apis/v1/perplexity/sonar', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/perplexity/sonar",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'messages' => [
        [
                'content' => 'What are the latest developments in quantum computing?',
                'role' => 'user'
        ]
    ],
    'model' => 'sonar'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/perplexity/sonar"

	payload := strings.NewReader("{\n  \"messages\": [\n    {\n      \"content\": \"What are the latest developments in quantum computing?\",\n      \"role\": \"user\"\n    }\n  ],\n  \"model\": \"sonar\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/perplexity/sonar")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"messages\": [\n    {\n      \"content\": \"What are the latest developments in quantum computing?\",\n      \"role\": \"user\"\n    }\n  ],\n  \"model\": \"sonar\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/perplexity/sonar")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"messages\": [\n    {\n      \"content\": \"What are the latest developments in quantum computing?\",\n      \"role\": \"user\"\n    }\n  ],\n  \"model\": \"sonar\"\n}"

response = http.request(request)
puts response.read_body

{
  "choices": [
    {
      "finish_reason": "stop",
      "index": 123,
      "message": {
        "content": "<string>",
        "role": "<string>"
      }
    }
  ],
  "citations": [
    "<string>"
  ],
  "created": 123,
  "id": "<string>",
  "model": "<string>",
  "object": "chat.completion",
  "search_results": [
    {
      "date": "<string>",
      "snippet": "<string>",
      "source": "<string>",
      "title": "<string>",
      "url": "<string>"
    }
  ],
  "usage": {
    "completion_tokens": 123,
    "prompt_tokens": 123,
    "search_context_size": "<string>",
    "total_tokens": 123
  }
}

POST

https://api.aisa.one

apis

perplexity

sonar

Reference example

# Fixed reference example. Playground inputs do not update this sample.
curl --request POST \
  --url https://api.aisa.one/apis/v1/perplexity/sonar \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "sonar",
  "messages": [
    {
      "role": "user",
      "content": "What are the latest developments in quantum computing?"
    }
  ]
}'

curl --request POST \
  --url https://api.aisa.one/apis/v1/perplexity/sonar \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "messages": [
    {
      "content": "What are the latest developments in quantum computing?",
      "role": "user"
    }
  ],
  "model": "sonar"
}
'

import requests

url = "https://api.aisa.one/apis/v1/perplexity/sonar"

payload = {
    "messages": [
        {
            "content": "What are the latest developments in quantum computing?",
            "role": "user"
        }
    ],
    "model": "sonar"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    messages: [
      {
        content: 'What are the latest developments in quantum computing?',
        role: 'user'
      }
    ],
    model: 'sonar'
  })
};

fetch('https://api.aisa.one/apis/v1/perplexity/sonar', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/perplexity/sonar",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'messages' => [
        [
                'content' => 'What are the latest developments in quantum computing?',
                'role' => 'user'
        ]
    ],
    'model' => 'sonar'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/perplexity/sonar"

	payload := strings.NewReader("{\n  \"messages\": [\n    {\n      \"content\": \"What are the latest developments in quantum computing?\",\n      \"role\": \"user\"\n    }\n  ],\n  \"model\": \"sonar\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/perplexity/sonar")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"messages\": [\n    {\n      \"content\": \"What are the latest developments in quantum computing?\",\n      \"role\": \"user\"\n    }\n  ],\n  \"model\": \"sonar\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/perplexity/sonar")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"messages\": [\n    {\n      \"content\": \"What are the latest developments in quantum computing?\",\n      \"role\": \"user\"\n    }\n  ],\n  \"model\": \"sonar\"\n}"

response = http.request(request)
puts response.read_body

{
  "choices": [
    {
      "finish_reason": "stop",
      "index": 123,
      "message": {
        "content": "<string>",
        "role": "<string>"
      }
    }
  ],
  "citations": [
    "<string>"
  ],
  "created": 123,
  "id": "<string>",
  "model": "<string>",
  "object": "chat.completion",
  "search_results": [
    {
      "date": "<string>",
      "snippet": "<string>",
      "source": "<string>",
      "title": "<string>",
      "url": "<string>"
    }
  ],
  "usage": {
    "completion_tokens": 123,
    "prompt_tokens": 123,
    "search_context_size": "<string>",
    "total_tokens": 123
  }
}

Ask a question and get a written answer with web citations, rather than a list of links to read yourself. Body is OpenAI chat-completions shaped: model (required, sonar) and messages. Returns choices[0].message.content as prose, plus citations (an array of URL strings) and search_results[] with title, url, snippet, date and source, and a usage block. Measured at about 3 seconds. Billed at a flat rate per request. This is the cheapest and fastest of the four Perplexity endpoints — use it for a single factual question. Step up to post_perplexity_sonar_pro for multi-part questions, or post_perplexity_sonar_reasoning_pro when the answer requires working through steps. If you need results you can iterate over rather than prose, use post_tavily_search; post_exa_answer answers the same shape of question with semantic retrieval.

Example

curl -X POST "https://api.aisa.one/apis/v1/perplexity/sonar" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sonar",
    "messages": [
      {"role": "user", "content": "What are the latest developments in quantum computing?"}
    ]
  }'

// Copy this whole block into Claude Code, Codex, Cursor or any coding agent.
// It carries everything needed to connect, authorize and run this example —
// no key to paste, one click of Allow in the browser.
{
  "calls": [
    {
      "call_id": "1",
      "tool": "post_perplexity_sonar",
      "arguments": {
        "model": "sonar",
        "messages": [
          {
            "role": "user",
            "content": "What are the latest developments in quantum computing?"
          }
        ]
      }
    }
  ]
}
// ── for the agent ─────────────────────────────────────────────────────────
// Register the AIsa MCP server, then call its `batch_quote` tool with the JSON above.
//   name       aisa
//   endpoint   https://mcp.aisa.one/mcp
//   transport  streamable-http
//   auth       OAuth. The server publishes RFC 9728 metadata, so open a
//              browser and the user clicks Allow once — nothing to paste.
//              If AISA_API_KEY is set, send it as a bearer header instead.
// Use your own MCP mechanism, not a hand-edited config file:
//   Codex        codex mcp add aisa --url https://mcp.aisa.one/mcp
//   Claude Code  claude mcp add --transport http -s user aisa https://mcp.aisa.one/mcp
//   Cursor / VS Code   a "url" entry for https://mcp.aisa.one/mcp in the MCP config
// The server reaches https://mcp.aisa.one/servers worth of APIs through a few meta
// tools: search, list_categories, get_details, batch_quote, batch_use.
// search, get_details and batch_quote are free; batch_use is billed per
// call. This operation's full contract — every argument, the response
// shape, the price and the pitfalls — is at
//   https://aisa.one/docs/api-reference/perplexity/post_perplexity-sonar.md
// Show me the quoted cost. Once I approve, run the same calls with
// batch_use and show me the result.

First time? Point any MCP client at https://mcp.aisa.one/mcp — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. Your agent then reaches every endpoint through a few meta tools: search, list_categories, get_details and batch_quote are free, batch_use is billed per call. Setup per client is in Connect via MCP; the live tool list and what each call costs are on aisa.one/mcp.

Set this endpoint up in your agent →

Request contract

Method and path: POST /apis/v1/perplexity/sonar
Availability: enabled
Request URL template: https://api.aisa.one/apis/v1/perplexity/sonar
Runtime facts: fb88776539957bfc86000a34a6c0da10e10cbeecf9d65c8ae1d78688c170faac

Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

{
  "operationId": "post_perplexity_sonar",
  "method": "POST",
  "path": "/apis/v1/perplexity/sonar",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "example": {
          "messages": [
            {
              "content": "What are the latest developments in quantum computing?",
              "role": "user"
            }
          ],
          "model": "sonar"
        },
        "schema": {
          "properties": {
            "frequency_penalty": {
              "default": 1,
              "description": "Penalizes new tokens based on their existing frequency in the text so far. Positive values decrease the likelihood of repeating the same line verbatim.",
              "maximum": 2,
              "minimum": 0,
              "type": "number"
            },
            "max_tokens": {
              "description": "The maximum number of tokens to generate in the response.",
              "type": "integer"
            },
            "messages": {
              "description": "A list of messages comprising the conversation so far.",
              "items": {
                "properties": {
                  "content": {
                    "description": "The content of the message.",
                    "type": "string"
                  },
                  "role": {
                    "description": "The role of the message author.",
                    "enum": [
                      "system",
                      "user",
                      "assistant"
                    ],
                    "type": "string"
                  }
                },
                "required": [
                  "role",
                  "content"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "model": {
              "description": "The Sonar model to use.",
              "enum": [
                "sonar",
                "sonar-pro",
                "sonar-reasoning-pro",
                "sonar-deep-research"
              ],
              "type": "string"
            },
            "presence_penalty": {
              "default": 0,
              "description": "Penalizes new tokens based on whether they appear in the text so far. Positive values increase the likelihood of talking about new topics.",
              "maximum": 2,
              "minimum": -2,
              "type": "number"
            },
            "return_citations": {
              "default": true,
              "description": "Whether to return citations and search results in the response.",
              "type": "boolean"
            },
            "search_context": {
              "default": "low",
              "description": "Controls how much search context to use. Affects per-request cost.",
              "enum": [
                "low",
                "medium",
                "high"
              ],
              "type": "string"
            },
            "search_domain_filter": {
              "description": "Limit search to specific domains.",
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "search_recency_filter": {
              "description": "Filter search results by recency.",
              "enum": [
                "month",
                "week",
                "day",
                "hour"
              ],
              "type": "string"
            },
            "stream": {
              "default": false,
              "description": "Whether to stream the response using server-sent events.",
              "type": "boolean"
            },
            "temperature": {
              "default": 0.2,
              "description": "Sampling temperature between 0 and 2. Lower values make output more focused and deterministic.",
              "maximum": 2,
              "minimum": 0,
              "type": "number"
            },
            "top_k": {
              "default": 0,
              "description": "The number of tokens to keep for top-k filtering.",
              "maximum": 2048,
              "minimum": 0,
              "type": "integer"
            },
            "top_p": {
              "default": 0.9,
              "description": "Nucleus sampling parameter. The model considers tokens with top_p probability mass.",
              "maximum": 1,
              "minimum": 0,
              "type": "number"
            }
          },
          "required": [
            "model",
            "messages"
          ],
          "type": "object"
        }
      }
    },
    "required": true
  },
  "x-aisa-status": "enabled",
  "x-aisa-pricing": {
    "cost_contract": "response_usd",
    "customer_multiplier": 1.0,
    "customer_pricing": "provider_cost_multiplier",
    "default_request_estimate_usd": 0.12783,
    "estimate_source": "profile_seed",
    "evidence_source": "response_body"
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}

Cost and request rules

Usage-based billing; Default request estimate: $0.12783 USD (not a fixed price). Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

Default request reference estimate (USD): 0.12783
Cost contract: response_usd
Published reference multiplier: 1.0
Settlement evidence source: response_body

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

messages

object[]

required

A list of messages comprising the conversation so far.

Show child attributes

model

enum<string>

required

The Sonar model to use.

Available options:

sonar,

sonar-pro,

sonar-reasoning-pro,

sonar-deep-research

frequency_penalty

number

default:1

Penalizes new tokens based on their existing frequency in the text so far. Positive values decrease the likelihood of repeating the same line verbatim.

Required range: 0 <= x <= 2

max_tokens

integer

The maximum number of tokens to generate in the response.

presence_penalty

number

default:0

Penalizes new tokens based on whether they appear in the text so far. Positive values increase the likelihood of talking about new topics.

Required range: -2 <= x <= 2

return_citations

boolean

default:true

Whether to return citations and search results in the response.

search_context

enum<string>

default:low

Controls how much search context to use. Affects per-request cost.

Available options:

low,

medium,

high

search_domain_filter

string[]

Limit search to specific domains.

search_recency_filter

enum<string>

Filter search results by recency.

Available options:

month,

week,

day,

hour

stream

boolean

default:false

Whether to stream the response using server-sent events.

temperature

number

default:0.2

Sampling temperature between 0 and 2. Lower values make output more focused and deterministic.

Required range: 0 <= x <= 2

top_k

integer

default:0

The number of tokens to keep for top-k filtering.

Required range: 0 <= x <= 2048

top_p

number

default:0.9

Nucleus sampling parameter. The model considers tokens with top_p probability mass.

Required range: 0 <= x <= 1

Response

Successful response with AI answer and citations

choices

object[]

Show child attributes

citations

string[]

List of source URLs referenced in the answer.

created

integer

Unix timestamp of when the completion was created.

string

Unique identifier for the completion.

model

string

The model used for the completion.

object

string

Example:

"chat.completion"

search_results

object[]

Detailed search results with titles, snippets, and URLs.

Show child attributes

usage

object

Show child attributes

Overview

Models

Search & Research

Finance & Crypto

CoinGecko

Duffel Flights

DataForSEO

Social & Media

SEO & Web Intel

Sales & Email

Travel & Other

Example

Request contract

Cost and request rules

Authorizations

Body

Response

​Example

​Request contract

​Cost and request rules

Authorizations

Body

Response

Example

Request contract

Cost and request rules