Гайд · TNWS AI

Как отправить первый запрос в Perplexity API и получить ответ с источниками

WindowsmacOSLinuxPerplexity#Perplexity API#Sonar#нейросети
2 мин

Практическое руководство по запросу «как подключить Perplexity API»: рабочий пример, реальные поля API, ограничения и проверка результата.

Perplexity API полезен, когда ответ должен опираться на веб-поиск. Ключ хранится на сервере, запрос передаётся выбранной актуальной модели, а приложение разбирает не только текст, но и массив citations или структурированные источники, предусмотренные текущим endpoint.

Рабочий пример

curl -X POST 'https://api.perplexity.ai/chat/completions' \
 -H "Authorization: Bearer $PERPLEXITY_API_KEY" \
 -H 'Content-Type: application/json' \
 -d '{"model":"sonar","messages":[{"role":"user","content":"Найди актуальное правило, укажи дату и первичный источник"}]}'

Практические факты

  • Текст без цитаты не считается проверенным результатом поиска.
  • Название модели и endpoint сверяются с актуальным Quickstart.
  • Для каждого источника сохраняйте URL, заголовок и связь с тезисом.
  • Сниппет выдачи не заменяет открытие первичной страницы.

Как внедрить

  1. Зафиксируйте задачу и формат результата.
  2. Храните ключ только на сервере и ограничьте доступ.
  3. Выполните запрос и разберите структурированные поля ответа.
  4. Добавьте таймаут, ограниченный retry и метрики usage/latency.
  5. Прогоните положительные, отрицательные и пограничные тесты.

Как проверить результат

Запросите правило, изменившееся в известную дату. Ответ должен содержать дату и ссылку на официальный документ. Затем спросите о несуществующем событии: корректный результат — отсутствие подтверждения.

Чего не делать

  • Не публикуйте API-ключ.
  • Не считайте уверенный текст доказательством.
  • Не записывайте данные без валидации.
  • Не повторяйте 429 или 5xx бесконечно.

Ограничения

Доступность моделей, регионов, функций и тарифов может меняться. Проверяйте официальный каталог на дату внедрения и не отправляйте чувствительные данные без оценки политики обработки.

FAQ

Можно ли использовать пример сразу в production?

Нет: добавьте таймауты, авторизацию, лимиты, журнал request ID и тесты.

Как выбирать модель?

По актуальному каталогу сервиса и eval на своих задачах.

Нужно ли проверять citations или JSON?

Да. Ссылка открывается вручную, JSON проходит схему, факты сверяются с первичным источником.

Почему цена может отличаться?

Тарифы зависят от даты, модели и режима; проверяйте официальную страницу перед расчётом.

Официальный источник

Проверено 12 сентября 2026 года: https://docs.perplexity.ai/

Читайте также

Комментарии

Пока тихо. Скажите первое слово