Felo API PlatformFelo API Platform
Все эндпоинты Perplexity
v0.2.0-beta
OpenAPI 3.1.0

Perplexity Sonar

Felo API Support
MIT
Сервер:https://openapi.felo.ai
Клиентские библиотеки
Shell Curl

Perplexity API

​

Generate answers and research reports with web citations.

Perplexity API Операции

Perplexity Sonar

​

Создаёт краткий ответ с веб-цитированием. model и messages обязательны; для этого эндпоинта используйте model sonar. Этот публичный контракт охватывает нестриминговые JSON-ответы со stream false. Читайте ответ в choices[].message.content, а источники — в citations и search_results. usage сообщает о потреблении ресурсов, а не о списании кредитов Felo.

Справочные цены

  • Тарификация: стоимость ответа по данным провайдера.
  • Справочная оценка запроса: USD 0.12783.
  • Справочный множитель для клиента: 1.0. Не применяйте его повторно к уже рассчитанной сумме клиента.

Справочные метаданные, а не коммерческое предложение для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo.

Тело
обязательно
application/json
  • messages
    Тип: array object[]
    обязательно

    Список сообщений, составляющих текущий диалог.

    • content
      Тип: string
      обязательно

      Содержимое сообщения.

    • role
      Тип: string enum
      обязательно

      Роль автора сообщения.

      значения
      • system
      • user
      • assistant
  • model
    Тип: string enum
    обязательно

    Используемая модель Sonar.

    значения
    • sonar
    • sonar-pro
    • sonar-reasoning-pro
    • sonar-deep-research
  • frequency_penalty
    Тип: number
    мин.:  
    0
    макс.:  
    2

    Штрафует новые токены на основе их текущей частоты в тексте. Положительные значения снижают вероятность дословного повторения той же строки.

  • max_tokens
    Тип: integer

    Максимальное количество токенов для генерации в ответе.

  • presence_penalty
    Тип: number
    мин.:  
    -2
    макс.:  
    2

    Штрафует новые токены в зависимости от того, встречались ли они в тексте. Положительные значения повышают вероятность обсуждения новых тем.

  • return_citations
    Тип: boolean

    Возвращать ли цитаты и результаты поиска в ответе.

  • search_context
    Тип: string enum

    Управляет объёмом используемого поискового контекста. Влияет на стоимость запроса.

    значения
    • low
    • medium
    • high
  • search_domain_filter
    Тип: array string[]

    Ограничить поиск определёнными доменами.

  • search_recency_filter
    Тип: string enum

    Фильтровать результаты поиска по давности.

    значения
    • month
    • week
    • day
    • hour
  • stream
    Тип: boolean

    Стримить ли ответ с помощью server-sent events.

  • temperature
    Тип: number
    мин.:  
    0
    макс.:  
    2

    Температура сэмплирования от 0 до 2. Меньшие значения делают вывод более сфокусированным и детерминированным.

  • top_k
    Тип: integer
    мин.:  
    0
    макс.:  
    2048

    Количество токенов, сохраняемых для top-k фильтрации.

  • top_p
    Тип: number
    мин.:  
    0
    макс.:  
    1

    Параметр нуклеусного сэмплирования. Модель учитывает токены с вероятностной массой top_p.

Ответы
  • 200
    Тип: object · ResponseD5E2470Dd28B_ChatCompletionResponse

    Успешный ответ с ИИ-ответом и цитированием

    • choices
      Тип: array object[]
      • finish_reason
        Тип: string enum
        значения
        • stop
        • length
      • index
        Тип: integer

        Integer numbers.

      • message
        Тип: object
        • content
          Тип: string

          Ответ, сгенерированный ИИ, со встроенными ссылками на цитаты вида [1][2].

        • role
          Тип: string
    • citations
      Тип: array string[]

      Список URL источников, на которые ссылаются в ответе.

    • created
      Тип: integer

      Временная метка Unix момента создания ответа.

    • id
      Тип: string

      Уникальный идентификатор ответа.

    • model
      Тип: string

      Модель, использованная для ответа.

    • object
      Тип: string
    • search_results
      Тип: array object[]

      Подробные результаты поиска с заголовками, фрагментами и URL.

      • date
        Тип: string
      • snippet
        Тип: string
      • source
        Тип: string
      • title
        Тип: string
      • url
        Тип: string
    • usage
      Тип: object
      • completion_tokens
        Тип: integer

        Integer numbers.

      • prompt_tokens
        Тип: integer

        Integer numbers.

      • search_context_size
        Тип: string
      • total_tokens
        Тип: integer

        Integer numbers.

    application/json
  • 400

    Запрос не удалось обработать. Проверьте параметры запроса.

  • 401

    Требуется действительный API-ключ Felo.

  • 402

    Запрос не может быть выполнен: не выполнено требование биллинга.

  • 403

    Аккаунту не разрешено выполнять эту операцию.

  • 429

    Достигнут лимит запросов или расходов.

  • 502

    Сервис не смог выполнить запрос.

  • 503

    API или сервис биллинга временно недоступны.

  • 504

    Истекло время ожидания обработки запроса.

  • default

    Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера

    application/json
Request Example for post/v1/beta/perplexity/sonar
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
  }
}

Успешный ответ с ИИ-ответом и цитированием

Perplexity Sonar

Нужна помощь?