Perplexity API
Generate answers and research reports with web citations.
Perplexity Sonar Reasoning Pro
Анализирует вопрос, требующий рассуждения с опорой на веб-поиск и цитирование. model и messages обязательны; для этого эндпоинта используйте model sonar-reasoning-pro. Этот публичный контракт охватывает нестриминговые JSON-ответы со stream false. Читайте ответ и его источники в choices[].message.content, citations и search_results. usage — не списание кредитов Felo.
Справочные цены
- Тарификация: стоимость ответа по данным провайдера.
- Справочная оценка запроса: USD 0.03499.
- Справочный множитель для клиента: 1.0. Не применяйте его повторно к уже рассчитанной сумме клиента.
Справочные метаданные, а не коммерческое предложение для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo.
- Тип: array object[]messagesобязательно
Список сообщений, составляющих текущий диалог.
- contentТип: stringобязательно
Содержимое сообщения.
- roleТип: string enumобязательно
Роль автора сообщения.
значения- system
- user
- assistant
- Тип: string enummodelобязательно
Используемая модель Sonar.
значения- sonar
- sonar
-pro - sonar
-reasoning -pro - sonar
-deep -research
- Тип: numberfrequency
_penalty мин.:0макс.:2Штрафует новые токены на основе их текущей частоты в тексте. Положительные значения снижают вероятность дословного повторения той же строки.
- Тип: integermax
_tokens Максимальное количество токенов для генерации в ответе.
- Тип: numberpresence
_penalty мин.:-2макс.:2Штрафует новые токены в зависимости от того, встречались ли они в тексте. Положительные значения повышают вероятность обсуждения новых тем.
- Тип: booleanreturn
_citations Возвращать ли цитаты и результаты поиска в ответе.
- Тип: string enumsearch
_context Управляет объёмом используемого поискового контекста. Влияет на стоимость запроса.
значения- low
- medium
- high
- Тип: array string[]search
_domain _filter Ограничить поиск определёнными доменами.
- Тип: string enumsearch
_recency _filter Фильтровать результаты поиска по давности.
значения- month
- week
- day
- hour
- Тип: booleanstream
Стримить ли ответ с помощью server-sent events.
- Тип: numbertemperatureмин.:0макс.:2
Температура сэмплирования от 0 до 2. Меньшие значения делают вывод более сфокусированным и детерминированным.
- Тип: integertop
_k мин.:0макс.:2048Количество токенов, сохраняемых для top-k фильтрации.
- Тип: numbertop
_p мин.:0макс.:1Параметр нуклеусного сэмплирования. Модель учитывает токены с вероятностной массой top_p.
- Тип: object · ResponseD5E2470Dd28B_ChatCompletionResponse200
Успешный ответ с ИИ-ответом и цитированием
- Тип: array object[]choices
- finishТип: string enum
_reason значения- stop
- length
- indexТип: integer
Integer numbers.
- messageТип: object
- contentТип: string
Ответ, сгенерированный ИИ, со встроенными ссылками на цитаты вида [1][2].
- roleТип: string
- Тип: array string[]citations
Список URL источников, на которые ссылаются в ответе.
- Тип: integercreated
Временная метка Unix момента создания ответа.
- Тип: stringid
Уникальный идентификатор ответа.
- Тип: stringmodel
Модель, использованная для ответа.
- Тип: stringobject
- Тип: array object[]search
_results Подробные результаты поиска с заголовками, фрагментами и URL.
- dateТип: string
- snippetТип: string
- sourceТип: string
- titleТип: string
- urlТип: string
- Тип: objectusage
- completionТип: integer
_tokens Integer numbers.
- promptТип: integer
_tokens Integer numbers.
- searchТип: string
_context _size - totalТип: integer
_tokens Integer numbers.
application/json - 400
Запрос не удалось обработать. Проверьте параметры запроса.
- 401
Требуется действительный API-ключ Felo.
- 402
Запрос не может быть выполнен: не выполнено требование биллинга.
- 403
Аккаунту не разрешено выполнять эту операцию.
- 429
Достигнут лимит запросов или расходов.
- 502
Сервис не смог выполнить запрос.
- 503
API или сервис биллинга временно недоступны.
- 504
Истекло время ожидания обработки запроса.
- default
Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера
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
}
}