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
- Создайте API key в Perplexity API Console (раздел API Keys).
- Экспортируйте:
export PERPLEXITY_API_KEY=…. - Поставьте SDK:
pip install perplexityai(илиnpm install @perplexity-ai/perplexity_ai). - Вызовите Agent с preset (проще всего) или с явным
model+input. - Для прода смотрите 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. Когда нужна система обучения под интеграции — форматы на странице обучения.
Хотите нейросети под свои задачи, а не «для всех»?
Когда базовых гайдов уже мало, помогает разбор под вашу работу. Наставничество, курсы и подписка Артёма Денисова — все форматы на странице обучения. Соседи по стеку — ИИ-автоматизация и OpenRouter.