> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Answers
## OpenAPI
````yaml openapi/brave-answer.json POST /apis/v1/brave/chat/completions
openapi: 3.1.0
info:
description: ''
title: Brave Answer
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-configured-paths:
- /apis/v1/brave/chat/completions
x-aisa-document:
facts_hash: b593d630f892a82e07050d1f4f146d4af9e5c8671586916d8d80380105770eae
generator_version: '2'
protocol_version: '1'
schema_version: '1'
composer_version: '13'
response_pending: []
document_hash: sha256:bd915f126d828864cea3a82c77a399e9f56f1aec1173b3818b4c0d4644747c92
x-aisa-plans:
builder: 1
display_plan: payg
payg: 1
similarweb_payg: 1
team: 1
version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
x-aisa-provider: brave-answer
x-aisa-catalogs:
brave-answer:
title: Brave Answer
description: ''
x-aisa-document:
facts_hash: b593d630f892a82e07050d1f4f146d4af9e5c8671586916d8d80380105770eae
generator_version: '2'
protocol_version: '1'
schema_version: '1'
x-aisa-plans:
builder: 1
display_plan: payg
payg: 1
similarweb_payg: 1
team: 1
version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
x-aisa-capabilities:
idempotency: Idempotency-Key
max_price: X-AISA-Max-Price-USD
quote:
header: X-AISA-Cost-Mode
value: quote
servers:
- url: https://api.aisa.one
security:
- bearerAuth: []
paths:
/apis/v1/brave/chat/completions:
post:
tags:
- default
summary: Answers
operationId: any_brave_answer_apis_v1_brave_chat_completions
requestBody:
required: true
description: ''
content:
application/json:
schema:
properties:
messages:
items:
properties:
role:
type: string
enum:
- user
const: user
title: Role
default: user
content:
type: string
title: Content
type: object
required:
- content
title: UserMessage
type: array
maxItems: 1
minItems: 1
title: Messages
description: >-
The conversation so far. Exactly one user
message is supported, e.g. [{"role":
"user", "content": "Explain quantum
computing"}].
model:
type: string
enum:
- brave-pro
- brave
title: Model
description: Model ID used to generate the response.
default: brave-pro
max_completion_tokens:
anyOf:
- type: integer
- type: 'null'
title: Max Completion Tokens
metadata:
anyOf:
- additionalProperties:
type: string
type: object
- type: 'null'
title: Metadata
description: >-
Accepted for OpenAI SDK compatibility and currently ignored:
the pairs are not stored or returned.
seed:
anyOf:
- type: integer
- type: 'null'
title: Seed
description: >-
Accepted for OpenAI SDK compatibility and currently ignored:
answers are not reproducible.
stream:
type: boolean
title: Stream
default: true
web_search_options:
anyOf:
- properties:
search_context_size:
anyOf:
- type: string
enum:
- low
- medium
- high
- type: 'null'
title: Search Context Size
user_location:
anyOf:
- properties:
approximate:
properties:
city:
anyOf:
- type: string
- type: 'null'
title: City
country:
anyOf:
- type: string
- type: 'null'
title: Country
region:
anyOf:
- type: string
- type: 'null'
title: Region
timezone:
anyOf:
- type: string
- type: 'null'
title: Timezone
type: object
title: ApproximateUserLocation
type:
type: string
enum:
- approximate
const: approximate
title: Type
default: approximate
type: object
required:
- approximate
title: UserLocation
- type: 'null'
type: object
title: WebSearchOptions
- type: 'null'
country:
type: string
title: Country
default: us
language:
type: string
title: Language
default: en
safesearch:
type: string
title: Safesearch
default: moderate
enable_entities:
type: boolean
title: Enable Entities
description: >-
Whether to include inline entity tags in the answer.
Requires stream=true and is not supported in
research mode.
default: false
enable_citations:
type: boolean
title: Enable Citations
description: >-
Whether to include inline citation tags in the answer.
Requires stream=true and is not supported in
research mode.
default: false
enable_research:
type: boolean
title: Enable Research
description: >-
Whether to answer with iterative deep research instead of a
single search. Requires stream=true.
default: false
research_allow_thinking:
type: boolean
title: Research Allow Thinking
description: >-
Accepted for compatibility. Ignored by the mixer engine
behind this API, which always runs research with extended
thinking off.
default: true
research_maximum_number_of_tokens_per_query:
type: integer
maximum: 16384
minimum: 1024
title: Research Maximum Number Of Tokens Per Query
description: Maximum number of tokens to gather per research query.
default: 8192
research_maximum_number_of_queries:
type: integer
maximum: 50
minimum: 1
title: Research Maximum Number Of Queries
description: >-
Maximum number of search queries research mode may issue in
total.
default: 20
research_maximum_number_of_iterations:
type: integer
maximum: 5
minimum: 1
title: Research Maximum Number Of Iterations
description: Maximum number of research iterations.
default: 4
research_maximum_number_of_seconds:
type: integer
maximum: 300
minimum: 1
title: Research Maximum Number Of Seconds
description: Time budget for research, in seconds.
default: 180
research_maximum_number_of_results_per_query:
type: integer
maximum: 60
minimum: 1
title: Research Maximum Number Of Results Per Query
description: >-
Maximum number of search results to consider per research
query.
default: 30
type: object
required:
- messages
title: OpenAIChatRequest
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ResponseE3Baaa015480_OpenAIChatResponse'
default:
content:
application/json:
schema: {}
description: >-
Error response; upstream passthrough responses may use provider
formats
components:
schemas:
ResponseE3Baaa015480_OpenAIChatResponse:
properties:
model:
type: string
enum:
- brave-pro
- brave
title: Model
default: brave-pro
system_fingerprint:
anyOf:
- type: string
- type: 'null'
title: System Fingerprint
choices:
items:
$ref: '#/components/schemas/ResponseE3Baaa015480_ChoiceChunk'
type: array
title: Choices
created:
type: integer
title: Created
id:
type: string
title: Id
object:
type: string
enum:
- chat.completion.chunk
const: chat.completion.chunk
title: Object
default: chat.completion.chunk
usage:
anyOf:
- $ref: '#/components/schemas/ResponseE3Baaa015480_OpenAIUsage'
- type: 'null'
type: object
required:
- choices
- created
- id
title: OpenAIChatResponse
ResponseE3Baaa015480_ChoiceChunk:
properties:
delta:
$ref: '#/components/schemas/ResponseE3Baaa015480_Delta'
finish_reason:
anyOf:
- type: string
enum:
- stop
- length
- type: 'null'
title: Finish Reason
type: object
required:
- delta
title: ChoiceChunk
ResponseE3Baaa015480_OpenAIUsage:
properties:
completion_tokens:
type: integer
title: Completion Tokens
prompt_tokens:
type: integer
title: Prompt Tokens
total_tokens:
type: integer
title: Total Tokens
completion_tokens_details:
anyOf:
- $ref: >-
#/components/schemas/ResponseE3Baaa015480_OpenAICompletionTokensDetails
- type: 'null'
type: object
required:
- completion_tokens
- prompt_tokens
- total_tokens
title: OpenAIUsage
ResponseE3Baaa015480_Delta:
properties:
role:
type: string
enum:
- assistant
const: assistant
title: Role
default: assistant
content:
type: string
title: Content
type: object
required:
- content
title: Delta
ResponseE3Baaa015480_OpenAICompletionTokensDetails:
properties:
reasoning_tokens:
anyOf:
- type: integer
- type: 'null'
title: Reasoning Tokens
type: object
title: OpenAICompletionTokensDetails
securitySchemes:
bearerAuth:
scheme: bearer
type: http
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.