Гайд · TNWS AI
Как отправить первый запрос в Perplexity API и получить ответ с источниками
Практическое руководство по запросу «как подключить 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, заголовок и связь с тезисом.
- Сниппет выдачи не заменяет открытие первичной страницы.
Как внедрить
- Зафиксируйте задачу и формат результата.
- Храните ключ только на сервере и ограничьте доступ.
- Выполните запрос и разберите структурированные поля ответа.
- Добавьте таймаут, ограниченный retry и метрики usage/latency.
- Прогоните положительные, отрицательные и пограничные тесты.
Как проверить результат
Запросите правило, изменившееся в известную дату. Ответ должен содержать дату и ссылку на официальный документ. Затем спросите о несуществующем событии: корректный результат — отсутствие подтверждения.
Чего не делать
- Не публикуйте API-ключ.
- Не считайте уверенный текст доказательством.
- Не записывайте данные без валидации.
- Не повторяйте 429 или 5xx бесконечно.
Ограничения
Доступность моделей, регионов, функций и тарифов может меняться. Проверяйте официальный каталог на дату внедрения и не отправляйте чувствительные данные без оценки политики обработки.
FAQ
Можно ли использовать пример сразу в production?
Нет: добавьте таймауты, авторизацию, лимиты, журнал request ID и тесты.
Как выбирать модель?
По актуальному каталогу сервиса и eval на своих задачах.
Нужно ли проверять citations или JSON?
Да. Ссылка открывается вручную, JSON проходит схему, факты сверяются с первичным источником.
Почему цена может отличаться?
Тарифы зависят от даты, модели и режима; проверяйте официальную страницу перед расчётом.
Официальный источник
Проверено 12 сентября 2026 года: https://docs.perplexity.ai/
Читайте также
Как ограничить поиск Perplexity API официальными сайтами
Практическое руководство по запросу «как настроить фильтр сайтов Perplexity API»: рабочий пример, реальные поля API, ограничения и проверка результата.
Как получить JSON от Perplexity API и не потерять цитаты
Практическое руководство по запросу «как получить JSON Perplexity API»: рабочий пример, реальные поля API, ограничения и проверка результата.
Как использовать Batch API xAI для большой пачки запросов Grok
Практическое руководство по запросу «как использовать Batch API Grok»: рабочий пример, реальные поля API, ограничения и проверка результата.
Комментарии
Пока тихо. Скажите первое слово