Perplexity API
Generate answers and research reports with web citations.
Perplexity Sonar Reasoning Pro
Analisa uma pergunta que exige raciocínio apoiado por pesquisa na web e citações. model e messages são obrigatórios; use o modelo sonar-reasoning-pro para este endpoint. Este contrato público cobre respostas JSON sem streaming com stream false. Leia choices[].message.content, citations e search_results para obter a resposta e suas fontes. usage não é uma cobrança em créditos Felo.
Referência de preços
- Medição: custo de resposta reportado.
- Estimativa de referência por requisição: USD 0.03499.
- Multiplicador de referência do cliente: 1.0. Não o aplique novamente a um valor de cliente já liquidado.
Apenas metadados de referência, não uma cotação da conta, um preço garantido ou um limite de gastos. Créditos de recursos não são créditos Felo. As cobranças finais seguem os registros de cobrança da Felo.
- Tipo: array object[]messagesobrigatório
Uma lista de mensagens que compõem a conversa até o momento.
- contentTipo: stringobrigatório
O conteúdo da mensagem.
- roleTipo: string enumobrigatório
O papel do autor da mensagem.
valores- system
- user
- assistant
- Tipo: string enummodelobrigatório
O modelo Sonar a usar.
valores- sonar
- sonar
-pro - sonar
-reasoning -pro - sonar
-deep -research
- Tipo: numberfrequency
_penalty mín:0máx:2Penaliza novos tokens com base na frequência existente deles no texto até o momento. Valores positivos reduzem a probabilidade de repetir a mesma linha literalmente.
- Tipo: integermax
_tokens O número máximo de tokens a gerar na resposta.
- Tipo: numberpresence
_penalty mín:-2máx:2Penaliza novos tokens com base em eles aparecerem ou não no texto até o momento. Valores positivos aumentam a probabilidade de falar sobre novos tópicos.
- Tipo: booleanreturn
_citations Se deve retornar citações e resultados de pesquisa na resposta.
- Tipo: string enumsearch
_context Controla quanto contexto de pesquisa usar. Afeta o custo por requisição.
valores- low
- medium
- high
- Tipo: array string[]search
_domain _filter Limita a pesquisa a domínios específicos.
- Tipo: string enumsearch
_recency _filter Filtra os resultados de pesquisa por recência.
valores- month
- week
- day
- hour
- Tipo: booleanstream
Se deve transmitir a resposta usando server-sent events.
- Tipo: numbertemperaturemín:0máx:2
Temperatura de amostragem entre 0 e 2. Valores mais baixos tornam a saída mais focada e determinística.
- Tipo: integertop
_k mín:0máx:2048O número de tokens a manter para a filtragem top-k.
- Tipo: numbertop
_p mín:0máx:1Parâmetro de amostragem de núcleo. O modelo considera tokens com massa de probabilidade top_p.
- Tipo: object · ResponseD5E2470Dd28B_ChatCompletionResponse200
Resposta bem-sucedida com resposta de IA e citações
- Tipo: array object[]choices
- finishTipo: string enum
_reason valores- stop
- length
- indexTipo: integer
Integer numbers.
- messageTipo: object
- contentTipo: string
A resposta gerada por IA, com referências de citação embutidas como [1][2].
- roleTipo: string
- Tipo: array string[]citations
Lista de URLs de origem referenciadas na resposta.
- Tipo: integercreated
Timestamp Unix de criação da conclusão.
- Tipo: stringid
Identificador exclusivo da conclusão.
- Tipo: stringmodel
O modelo usado na conclusão.
- Tipo: stringobject
- Tipo: array object[]search
_results Resultados de pesquisa detalhados com títulos, trechos e URLs.
- dateTipo: string
- snippetTipo: string
- sourceTipo: string
- titleTipo: string
- urlTipo: string
- Tipo: objectusage
- completionTipo: integer
_tokens Integer numbers.
- promptTipo: integer
_tokens Integer numbers.
- searchTipo: string
_context _size - totalTipo: integer
_tokens Integer numbers.
application/json - 400
Não foi possível processar a requisição. Verifique os parâmetros da requisição.
- 401
É necessária uma chave de API da Felo válida.
- 402
A requisição não pode prosseguir porque um requisito de cobrança não foi atendido.
- 403
A conta não tem permissão para realizar esta operação.
- 429
Um limite de requisições ou de gastos foi atingido.
- 502
O serviço não pôde concluir a requisição.
- 503
A API ou o serviço de cobrança está temporariamente indisponível.
- 504
O serviço atingiu o tempo limite ao processar a requisição.
- default
Resposta de erro; respostas repassadas do upstream podem usar formatos do provedor
application/json
curl --request POST https://openapi.felo.ai/v1/beta/perplexity/sonar-reasoning-pro \
--header "Authorization: Bearer ${FELO_API_KEY:?Set FELO_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{"model": "sonar-reasoning-pro", "messages": [{"role": "user", "content": "Explain when conditional HTTP requests save bandwidth, citing the standards."}], "max_tokens": 2048, "stream": false}'
{
"id": "example-sonar-reasoning-pro-completion",
"model": "sonar-reasoning-pro",
"object": "chat.completion",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "A successful cache validation can avoid transferring an unchanged body. [1]"
},
"finish_reason": "stop"
}
],
"citations": [
"https://www.rfc-editor.org/rfc/rfc9110.html"
],
"search_results": [
{
"title": "HTTP Semantics",
"url": "https://www.rfc-editor.org/rfc/rfc9110.html"
}
],
"usage": {
"prompt_tokens": 30,
"completion_tokens": 50,
"total_tokens": 80
}
}