{"components":{"callbacks":{},"examples":{},"headers":{},"links":{},"parameters":{},"pathItems":{},"requestBodies":{},"responses":{},"schemas":{"ManualD5E2470Dd28B_ChatCompletionRequest":{"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"},"ResponseD5E2470Dd28B_ChatCompletionResponse":{"properties":{"choices":{"items":{"properties":{"finish_reason":{"enum":["stop","length"],"type":"string"},"index":{"type":"integer"},"message":{"properties":{"content":{"description":"The AI-generated answer, with inline citation references like [1][2].","type":"string"},"role":{"type":"string"}},"type":"object"}},"type":"object"},"type":"array"},"citations":{"description":"List of source URLs referenced in the answer.","items":{"type":"string"},"type":"array"},"created":{"description":"Unix timestamp of when the completion was created.","type":"integer"},"id":{"description":"Unique identifier for the completion.","type":"string"},"model":{"description":"The model used for the completion.","type":"string"},"object":{"example":"chat.completion","type":"string"},"search_results":{"description":"Detailed search results with titles, snippets, and URLs.","items":{"properties":{"date":{"type":"string"},"snippet":{"type":"string"},"source":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"}},"type":"object"},"type":"array"},"usage":{"properties":{"completion_tokens":{"type":"integer"},"prompt_tokens":{"type":"integer"},"search_context_size":{"type":"string"},"total_tokens":{"type":"integer"}},"type":"object"}},"type":"object"}},"securitySchemes":{"bearerAuth":{"scheme":"bearer","type":"http"}}},"info":{"description":"","title":"Perplexity","version":"1","x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","quote":{"header":"X-AISA-Cost-Mode","value":"quote"}},"x-aisa-catalogs":{"perplexity":{"description":"","title":"Perplexity","x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","quote":{"header":"X-AISA-Cost-Mode","value":"quote"}},"x-aisa-document":{"facts_hash":"fb88776539957bfc86000a34a6c0da10e10cbeecf9d65c8ae1d78688c170faac","generator_version":"3","protocol_version":"1","schema_version":"1"},"x-aisa-plans":{"builder":1.0,"display_plan":"payg","payg":1.0,"similarweb_payg":1.0,"team":1.0,"version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb"}}},"x-aisa-configured-paths":["/apis/v1/perplexity/sonar","/apis/v1/perplexity/sonar-deep-research","/apis/v1/perplexity/sonar-pro","/apis/v1/perplexity/sonar-reasoning-pro"],"x-aisa-document":{"composer_version":"20","document_hash":"sha256:7be0a2d7f2940f758509c34bb8772368691ccdf66776371092fea5e5e3a5df91","facts_hash":"fb88776539957bfc86000a34a6c0da10e10cbeecf9d65c8ae1d78688c170faac","generator_version":"3","protocol_version":"1","response_pending":[],"schema_version":"1"},"x-aisa-plans":{"builder":1.0,"display_plan":"payg","payg":1.0,"similarweb_payg":1.0,"team":1.0,"version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb"},"x-aisa-provider":"perplexity"},"jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","openapi":"3.1.0","paths":{"/apis/v1/perplexity/sonar":{"post":{"description":"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.  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`;\n\n<!-- aisa-pricing:start -->\nUsage-based billing; Default request estimate: $0.12783 USD (not a fixed price). Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","operationId":"post_perplexity_sonar","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},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseD5E2470Dd28B_ChatCompletionResponse"}}},"description":"Successful response with AI answer and citations"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"summary":"Sonar","tags":["sonar"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"perplexity","x-aisa-category":"8","x-aisa-docs-url":"https://aisa.one/docs/api-reference/perplexity/post_perplexity-sonar","x-aisa-passthrough":true,"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"},"x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-response-source":{"content_hash":"sha256:3de546acfbc35fe10299dd39118fdae6cea053a9322e554b9cff1bccde49ef95","kind":"upstream_success_contract","source":{"content_hash":"sha256:07e2e814c08705cd8136a84bcad0aad8720ea610ded80370df5336619f5f8120","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:d4e0227f576eaefb2bbf8ac815de2ecf87575cd62b6bd2de9ea5a93af1384144","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/perplexity-openapi.json"}},"x-aisa-revision":{"customer_pricing_ref":"05abe7ecc3d9","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"60c8ec16df32"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_perplexity_sonar","path":"/apis/v1/perplexity/sonar"},"x-aisa-source":{"content_hash":"sha256:07e2e814c08705cd8136a84bcad0aad8720ea610ded80370df5336619f5f8120","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:d4e0227f576eaefb2bbf8ac815de2ecf87575cd62b6bd2de9ea5a93af1384144","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/perplexity-openapi.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/chat/completions","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n  --url https://api.aisa.one/apis/v1/perplexity/sonar \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n  \"model\": \"sonar\",\n  \"messages\": [\n    {\n      \"role\": \"user\",\n      \"content\": \"What are the latest developments in quantum computing?\"\n    }\n  ]\n}'"}]}},"/apis/v1/perplexity/sonar-deep-research":{"post":{"description":"Commission a report: this endpoint runs many searches and writes a long, cited document. `model` (required, `sonar-deep-research`) and `messages` in; `choices[0].message.content`, `citations`, `search_results[]` and `usage` out, where `usage` also reports `num_search_queries` and `reasoning_tokens`.  Many clients time out well before it answers, so call it only when a report is genuinely the deliverable, and never in a loop. For anything you would read in one sitting, the other three Perplexity endpoints answer in seconds.\n\n<!-- aisa-pricing:start -->\nUsage-based billing; Default request estimate: $0.23932 USD (not a fixed price). Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","operationId":"post_perplexity_sonar_deep_research","requestBody":{"content":{"application/json":{"example":{"messages":[{"content":"Write a comprehensive analysis of the global semiconductor supply chain risks in 2026","role":"user"}],"model":"sonar-deep-research"},"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},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseD5E2470Dd28B_ChatCompletionResponse"}}},"description":"Successful response with AI answer and citations"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"summary":"Sonar Deep Research","tags":["sonar"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"perplexity","x-aisa-category":"8","x-aisa-docs-url":"https://aisa.one/docs/api-reference/perplexity/post_perplexity-sonar-deep-research","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_usd","customer_multiplier":1.0,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.23932,"estimate_source":"profile_seed","evidence_source":"response_body"},"x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-response-source":{"content_hash":"sha256:3de546acfbc35fe10299dd39118fdae6cea053a9322e554b9cff1bccde49ef95","kind":"upstream_success_contract","source":{"content_hash":"sha256:07e2e814c08705cd8136a84bcad0aad8720ea610ded80370df5336619f5f8120","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:d4e0227f576eaefb2bbf8ac815de2ecf87575cd62b6bd2de9ea5a93af1384144","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/perplexity-openapi.json"}},"x-aisa-revision":{"customer_pricing_ref":"05abe7ecc3d9","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"25135d81ede5"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_perplexity_sonar_deep_research","path":"/apis/v1/perplexity/sonar-deep-research"},"x-aisa-source":{"content_hash":"sha256:07e2e814c08705cd8136a84bcad0aad8720ea610ded80370df5336619f5f8120","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:d4e0227f576eaefb2bbf8ac815de2ecf87575cd62b6bd2de9ea5a93af1384144","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/perplexity-openapi.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/chat/completions","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n  --url https://api.aisa.one/apis/v1/perplexity/sonar-deep-research \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n  \"model\": \"sonar-deep-research\",\n  \"messages\": [\n    {\n      \"role\": \"user\",\n      \"content\": \"Write a comprehensive analysis of the global semiconductor supply chain risks in 2026\"\n    }\n  ]\n}'"}]}},"/apis/v1/perplexity/sonar-pro":{"post":{"description":"Ask a question that needs more than one search pass and get a written answer with citations. Same request and response shape as `post_perplexity_sonar` — `model` (required, `sonar-pro`) and `messages` in, `choices[0].message.content`, `citations`, `search_results[]` and `usage` out.  Use it for questions with several parts or follow-ups. For a single lookup `sonar` answers in a third of the time at the same price; when the difficulty is reasoning rather than retrieval, `post_perplexity_sonar_reasoning_pro` shows its working.\n\n<!-- aisa-pricing:start -->\nUsage-based billing; Default request estimate: $0.11273 USD (not a fixed price). Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","operationId":"post_perplexity_sonar_pro","requestBody":{"content":{"application/json":{"example":{"messages":[{"content":"Compare the economic policies of the US and EU regarding AI regulation in 2025-2026","role":"user"}],"model":"sonar-pro"},"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},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseD5E2470Dd28B_ChatCompletionResponse"}}},"description":"Successful response with AI answer and citations"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"summary":"Sonar Pro","tags":["sonar"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"perplexity","x-aisa-category":"8","x-aisa-docs-url":"https://aisa.one/docs/api-reference/perplexity/post_perplexity-sonar-pro","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_usd","customer_multiplier":1.0,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.11273,"estimate_source":"profile_seed","evidence_source":"response_body"},"x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-response-source":{"content_hash":"sha256:3de546acfbc35fe10299dd39118fdae6cea053a9322e554b9cff1bccde49ef95","kind":"upstream_success_contract","source":{"content_hash":"sha256:07e2e814c08705cd8136a84bcad0aad8720ea610ded80370df5336619f5f8120","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:d4e0227f576eaefb2bbf8ac815de2ecf87575cd62b6bd2de9ea5a93af1384144","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/perplexity-openapi.json"}},"x-aisa-revision":{"customer_pricing_ref":"05abe7ecc3d9","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"2dcbdb41b9f2"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_perplexity_sonar_pro","path":"/apis/v1/perplexity/sonar-pro"},"x-aisa-source":{"content_hash":"sha256:07e2e814c08705cd8136a84bcad0aad8720ea610ded80370df5336619f5f8120","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:d4e0227f576eaefb2bbf8ac815de2ecf87575cd62b6bd2de9ea5a93af1384144","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/perplexity-openapi.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/chat/completions","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n  --url https://api.aisa.one/apis/v1/perplexity/sonar-pro \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n  \"model\": \"sonar-pro\",\n  \"messages\": [\n    {\n      \"role\": \"user\",\n      \"content\": \"Compare the economic policies of the US and EU regarding AI regulation in 2025-2026\"\n    }\n  ]\n}'"}]}},"/apis/v1/perplexity/sonar-reasoning-pro":{"post":{"description":"Ask a question that has to be worked through, not just looked up, and get a step-by-step answer backed by web search. Same shape as the other Perplexity endpoints — `model` (required, `sonar-reasoning-pro`) and `messages` in; `choices[0].message.content`, `citations`, `search_results[]` and `usage` out.  Use it for comparison, causation and analysis. When the question is simply what is the case, `post_perplexity_sonar` is faster; when you need a long report over many sources rather than an answer, `post_perplexity_sonar_deep_research`.\n\n<!-- aisa-pricing:start -->\nUsage-based billing; Default request estimate: $0.03499 USD (not a fixed price). Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","operationId":"post_perplexity_sonar_reasoning_pro","requestBody":{"content":{"application/json":{"example":{"messages":[{"content":"Analyze whether Tesla stock is overvalued based on current P/E ratio compared to industry averages","role":"user"}],"model":"sonar-reasoning-pro"},"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},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseD5E2470Dd28B_ChatCompletionResponse"}}},"description":"Successful response with AI answer and citations"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"summary":"Sonar Reasoning Pro","tags":["sonar"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"perplexity","x-aisa-category":"8","x-aisa-docs-url":"https://aisa.one/docs/api-reference/perplexity/post_perplexity-sonar-reasoning-pro","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_usd","customer_multiplier":1.0,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.03499,"estimate_source":"profile_seed","evidence_source":"response_body"},"x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-response-source":{"content_hash":"sha256:3de546acfbc35fe10299dd39118fdae6cea053a9322e554b9cff1bccde49ef95","kind":"upstream_success_contract","source":{"content_hash":"sha256:07e2e814c08705cd8136a84bcad0aad8720ea610ded80370df5336619f5f8120","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:d4e0227f576eaefb2bbf8ac815de2ecf87575cd62b6bd2de9ea5a93af1384144","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/perplexity-openapi.json"}},"x-aisa-revision":{"customer_pricing_ref":"05abe7ecc3d9","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"e2b0f51a2594"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_perplexity_sonar_reasoning_pro","path":"/apis/v1/perplexity/sonar-reasoning-pro"},"x-aisa-source":{"content_hash":"sha256:07e2e814c08705cd8136a84bcad0aad8720ea610ded80370df5336619f5f8120","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:d4e0227f576eaefb2bbf8ac815de2ecf87575cd62b6bd2de9ea5a93af1384144","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/perplexity-openapi.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/chat/completions","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n  --url https://api.aisa.one/apis/v1/perplexity/sonar-reasoning-pro \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n  \"model\": \"sonar-reasoning-pro\",\n  \"messages\": [\n    {\n      \"role\": \"user\",\n      \"content\": \"Analyze whether Tesla stock is overvalued based on current P/E ratio compared to industry averages\"\n    }\n  ]\n}'"}]}}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}]}