Perplexity API — это программный доступ к платформе Perplexity: ключ PERPLEXITY_API_KEY, SDK perplexityai и вызовы Agent (client.responses.create), Orchestrator, Search и Embeddings. Фокус-ключ: perplexity api. Канон: Overview, Quickstart, Agent API. Соседи: OpenRouter, Gemini API, OpenAI API, ИИ-автоматизация. Чат/веб-гайд — отдельно: как пользоваться Perplexity.

Ниже — маршрут разработчика: ключ в API Console → SDK → один Agent-вызов (или Orchestrator). Model id, presets и тарифы сверяйте на дату запуска; рублевый прайс не фиксируем.

Четыре API на одной платформе

API Суть Старт Когда
Agent API web-grounded + multi-provider client.responses.create / POST /v1/agent research, цитаты, агенты
Orchestrator open-weight через OpenAI/Anthropic SDK base_url=…/router/v1 свой chat completions стек
Search API сырой ranked web search Search quickstart свой LLM поверх поиска
Embeddings векторы для RAG Embeddings docs семантика / индекс
CLI / MCP pplx и MCP servers docs CLI / MCP терминал и другие агенты

Источник: docs.perplexity.ai overview + quickstart (4 API, pip install perplexityai, PERPLEXITY_API_KEY); agent-api/quickstart (POST /v1/agent, responses.create, presets); migrate-from-sonar (Sonar support ended 2026-09-27). Сверка: 2026-10-12. ₽ не выдумываем.

Первый вызов Agent API

  1. Создайте API key в Perplexity API Console (раздел API Keys).
  2. Экспортируйте: export PERPLEXITY_API_KEY=….
  3. Поставьте SDK: pip install perplexityai (или npm install @perplexity-ai/perplexity_ai).
  4. Вызовите Agent с preset (проще всего) или с явным model + input.
  5. Для прода смотрите pricing, rate limits и актуальный каталог моделей/presets в доке на дату запуска.
export PERPLEXITY_API_KEY="YOUR_API_KEY"
pip install perplexityai

from perplexity import Perplexity

client = Perplexity()

# Простой старт: preset (fast / low / medium / high / xhigh)
response = client.responses.create(
    preset="fast",
    input="What are the latest developments in AI agents?",
)
print(response.output_text)

# Или явная модель из каталога Agent API
response = client.responses.create(
    model="openai/gpt-5.6-sol",  # сверяйте каталог на дату запуска
    input="Explain supervised vs unsupervised learning briefly.",
)
print(response.output_text)

REST: POST https://api.perplexity.ai/v1/agent с заголовком Authorization: Bearer $PERPLEXITY_API_KEY. Alias для OpenAI SDK: /v1/responses. Orchestrator: OpenAI SDK с base_url="https://api.perplexity.ai/router/v1" и model из каталога Orchestrator (в quickstart пример — perplexity/kimi-k3). Ключ держите в env, не в репозитории.

Типичные ошибки

  • Путать веб Perplexity и Perplexity API — разные сценарии и ключи доступа.
  • Оставлять старый Sonar Chat Completions без миграции на Agent (support ended 27.09.2026).
  • Фиксировать model id навсегда — каталог и presets обновляются в доке.
  • Коммитить PERPLEXITY_API_KEY в git или в публичный фронтенд.
  • Выдумывать рублевые тарифы — смотрите pricing и API Console.

FAQ: Perplexity API

Что такое Perplexity API простыми словами?

Perplexity API — это платформа для разработчиков: Agent API (web-grounded ответы и multi-provider модели), Orchestrator (open-weight через OpenAI/Anthropic-совместимый endpoint), Search API и Embeddings. Канон: docs.perplexity.ai.

Чем эта статья отличается от гайда «как пользоваться Perplexity»?

Пост /perplexity-kak-polzovatsya/ — про веб/чат с источниками. Здесь фокус на API: ключ PERPLEXITY_API_KEY, SDK perplexityai, Agent/Orchestrator/Search. Разные intent и focus_keyword: perplexity api.

С чего начать первый вызов?

Создайте ключ в API Console, export PERPLEXITY_API_KEY, pip install perplexityai, затем client.responses.create(preset=»fast», input=…). Альтернатива — model + input без preset. Endpoint Agent: POST https://api.perplexity.ai/v1/agent.

Sonar Chat Completions ещё работает?

Дока рекомендует Agent API для новых проектов. Поддержка Sonar Chat Completions завершилась 27.09.2026; sync/streaming могут реформулироваться в Agent, async Sonar — нет. Миграция: docs.perplexity.ai Agent API migrate-from-sonar.

Чем Agent отличается от Orchestrator?

Agent — web-grounded ответы, presets, tools, multi-provider модели. Orchestrator — прямой доступ к open-weight моделям Perplexity через base_url https://api.perplexity.ai/router/v1 (OpenAI/Anthropic-совместимый). Выбор — в quickstart Choosing the Right API.

Есть ли цены в рублях в статье?

Нет. Смотрите docs.perplexity.ai pricing и биллинг в API Console. Pay-as-you-go без обязательной подписки по доке; рубли не фиксируем.

Вывод

Perplexity API — ключ в env, perplexityai, один Agent-вызов с preset или model. Старт: Quickstart → свой скрипт → сверка pricing/presets. Когда нужна система обучения под интеграции — форматы на странице обучения.

Артём Денисов — эксперт Нетологии и автор курса Яндекс Практикума по промпт-инжинирингу. Сверяет Perplexity API с официальной докой на дату публикации.

Хотите нейросети под свои задачи, а не «для всех»?

Когда базовых гайдов уже мало, помогает разбор под вашу работу. Наставничество, курсы и подписка Артёма Денисова — все форматы на странице обучения. Соседи по стеку — ИИ-автоматизация и OpenRouter.