Perplexity API
Generate answers and research reports with web citations.
Perplexity Sonar
Genera una respuesta concisa con citas web. model y messages son obligatorios; usa el modelo sonar para este endpoint. Este contrato público cubre respuestas JSON sin streaming con stream false. Lee la respuesta en choices[].message.content y las fuentes en citations y search_results. usage informa del consumo de recursos, no de un cargo en créditos de Felo.
Referencia de precios
- Medición: costo de respuesta reportado.
- Estimación de referencia por solicitud: USD 0.12783.
- Multiplicador de referencia del cliente: 1.0. No lo apliques de nuevo a un importe de cliente ya liquidado.
Solo metadatos de referencia, no una cotización de la cuenta, un precio garantizado ni un límite de gasto. Los créditos de recursos no son créditos de Felo. Los cargos finales se rigen por los registros de facturación de Felo.
- Tipo: array object[]messagesobligatorio
Una lista de mensajes que componen la conversación hasta el momento.
- contentTipo: stringobligatorio
El contenido del mensaje.
- roleTipo: string enumobligatorio
El rol del autor del mensaje.
valores- system
- user
- assistant
- Tipo: string enummodelobligatorio
El modelo Sonar que se va a usar.
valores- sonar
- sonar
-pro - sonar
-reasoning -pro - sonar
-deep -research
- Tipo: numberfrequency
_penalty mín.:0máx.:2Penaliza los tokens nuevos según su frecuencia existente en el texto hasta el momento. Los valores positivos reducen la probabilidad de repetir la misma línea literalmente.
- Tipo: integermax
_tokens El número máximo de tokens que se generarán en la respuesta.
- Tipo: numberpresence
_penalty mín.:-2máx.:2Penaliza los tokens nuevos según si aparecen en el texto hasta el momento. Los valores positivos aumentan la probabilidad de hablar de temas nuevos.
- Tipo: booleanreturn
_citations Si se deben devolver citas y resultados de búsqueda en la respuesta.
- Tipo: string enumsearch
_context Controla cuánto contexto de búsqueda se usa. Afecta al costo por solicitud.
valores- low
- medium
- high
- Tipo: array string[]search
_domain _filter Limita la búsqueda a dominios específicos.
- Tipo: string enumsearch
_recency _filter Filtra los resultados de búsqueda por recencia.
valores- month
- week
- day
- hour
- Tipo: booleanstream
Si se debe transmitir la respuesta mediante server-sent events.
- Tipo: numbertemperaturemín.:0máx.:2
Temperatura de muestreo entre 0 y 2. Los valores más bajos hacen que la salida sea más enfocada y determinista.
- Tipo: integertop
_k mín.:0máx.:2048El número de tokens que se conservarán para el filtrado top-k.
- Tipo: numbertop
_p mín.:0máx.:1Parámetro de muestreo de núcleo. El modelo considera los tokens con masa de probabilidad top_p.
- Tipo: object · ResponseD5E2470Dd28B_ChatCompletionResponse200
Respuesta correcta con respuesta de IA y citas
- Tipo: array object[]choices
- finishTipo: string enum
_reason valores- stop
- length
- indexTipo: integer
Integer numbers.
- messageTipo: object
- contentTipo: string
La respuesta generada por IA, con referencias de cita en línea como [1][2].
- roleTipo: string
- Tipo: array string[]citations
Lista de URL de origen referenciadas en la respuesta.
- Tipo: integercreated
Marca temporal Unix de creación de la finalización.
- Tipo: stringid
Identificador único de la finalización.
- Tipo: stringmodel
El modelo utilizado en la finalización.
- Tipo: stringobject
- Tipo: array object[]search
_results Resultados de búsqueda detallados con títulos, fragmentos y URL.
- 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
No se pudo procesar la solicitud. Comprueba los parámetros de la solicitud.
- 401
Se requiere una clave de API de Felo válida.
- 402
La solicitud no puede continuar porque no se cumple un requisito de facturación.
- 403
La cuenta no tiene permiso para realizar esta operación.
- 429
Se ha alcanzado un límite de solicitudes o de gasto.
- 502
El servicio no pudo completar la solicitud.
- 503
La API o el servicio de facturación no están disponibles temporalmente.
- 504
El servicio agotó el tiempo de espera al procesar la solicitud.
- default
Respuesta de error; las respuestas de paso del upstream pueden usar formatos del proveedor
application/json
curl --request POST https://openapi.felo.ai/v1/beta/perplexity/sonar \
--header "Authorization: Bearer ${FELO_API_KEY:?Set FELO_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{"model": "sonar", "messages": [{"role": "user", "content": "What is HTTP caching? Cite the relevant documentation."}], "max_tokens": 512, "stream": false}'
{
"id": "example-sonar-completion",
"model": "sonar",
"object": "chat.completion",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "HTTP caching reuses stored responses when permitted by cache rules. [1]"
},
"finish_reason": "stop"
}
],
"citations": [
"https://www.rfc-editor.org/rfc/rfc9111.html"
],
"search_results": [
{
"title": "HTTP Caching",
"url": "https://www.rfc-editor.org/rfc/rfc9111.html"
}
],
"usage": {
"prompt_tokens": 20,
"completion_tokens": 30,
"total_tokens": 50
}
}