Гайд · TNWS AI

Как получить JSON от Perplexity API и не потерять цитаты

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

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

Структурированный ответ нужен для автоматизации, но citations нельзя зашивать в свободный текст и терять при JSON.parse. Задайте схему бизнес-данных, отдельно сохраните метаданные источников из API и валидируйте оба слоя.

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

const schema={type:"object",properties:{answer:{type:"string"},as_of:{type:["string","null"]},confirmed:{type:"boolean"}},required:["answer","as_of","confirmed"]};
// Передайте schema через актуальный response_format.
// После ответа: JSON.parse(content), validate(schema),
// отдельно сохранить citations из объекта API.

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

  • JSON Schema проверяет форму, но не истинность answer.
  • as_of:null лучше выдуманной даты.
  • Citation должна подтверждать конкретное поле или тезис.
  • При обрыве/лимите нельзя извлекать JSON регулярным выражением.

Как внедрить

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

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

Прогоните факт с датой, факт без даты и ложную предпосылку. Валидатор должен принять структуру, а confirmed быть false, если первичного подтверждения нет.

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

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

Ограничения

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

FAQ

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

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

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

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

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

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

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

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

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

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

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

Комментарии

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