Perplexity AI API

Обзор Perplexity AI

Perplexity AI — это передовая платформа для интеллектуального поиска и генерации ответов на основе актуальной информации из интернета. В отличие от традиционных языковых моделей, Perplexity AI объединяет мощь больших языковых моделей с возможностью поиска в реальном времени, предоставляя точные, обоснованные ответы с указанием источников.

Ключевые особенности

Уникальные возможности Perplexity AI

• Интеллектуальный поиск — AI-ассистированный поиск с пониманием контекста и семантики
• Ответы с источниками — каждый ответ сопровождается ссылками на использованные источники
• Поддержка различных форматов — текстовые ответы, структурированные данные, изображения
• Контекст 128K токенов — обработка длинных документов и сложных запросов
• Мультиязычность — поддержка более 50 языков, включая русский
• Актуальность данных — информация обновляется в реальном времени из надежных источников

Технические преимущества

Быстрый старт

pip install perplexity-ai

npm install perplexity-ai

# Используйте любой HTTP клиент

import perplexity

# Инициализация клиента
client = perplexity.Client(api_key="your-api-key")

# Простой запрос с поиском
response = client.chat.completions.create(
    model="pplx-7b-online",
    messages=[
        {"role": "user", "content": "Какие последние новости в области ИИ?"}
    ],
    search=True  # Включить поиск в интернете
)

print(response.choices[0].message.content)

# Вывод источников
if hasattr(response.choices[0].message, 'sources'):
    for source in response.choices[0].message.sources:
        print(f"Источник: {source.url}")

const { Perplexity } = require('perplexity-ai');

// Инициализация клиента
const client = new Perplexity({
    apiKey: 'your-api-key'
});

// Простой запрос
async function askPerplexity() {
    try {
        const response = await client.chat.completions.create({
            model: 'pplx-7b-online',
            messages: [
                { role: 'user', content: 'Какие последние новости в области ИИ?' }
            ],
            search: true
        });
        
        console.log('Ответ:', response.choices[0].message.content);
        
        // Вывод источников
        if (response.choices[0].message.sources) {
            response.choices[0].message.sources.forEach(source => {
                console.log(`Источник: ${source.url}`);
            });
        }
    } catch (error) {
        console.error('Ошибка:', error);
    }
}

askPerplexity();

Аутентификация

Использование API-ключа

Все запросы к Perplexity AI API должны содержать ваш API-ключ в заголовке авторизации:

Authorization: Bearer pplx-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Content-Type: application/json

Безопасность ключей

• Никогда не публикуйте API-ключи в клиентском коде или публичных репозиториях
• Используйте переменные окружения для хранения ключей
• Регулярно обновляйте ключи каждые 90 дней
• Создавайте разные ключи для разных сред (разработка, тестирование, продакшн)

import os
from dotenv import load_dotenv
import perplexity

# Загрузка переменных окружения из .env файла
load_dotenv()

# Получение ключа из переменных окружения
api_key = os.getenv('PERPLEXITY_API_KEY')

if not api_key:
    raise ValueError("PERPLEXITY_API_KEY not found in environment variables")

# Инициализация клиента
client = perplexity.Client(api_key=api_key)

Справочник API

Базовый URL

Создание чат-завершения

POST /chat/completions
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "model": "pplx-70b-online",
  "messages": [
    {
      "role": "system",
      "content": "Ты полезный ассистент, который предоставляет точные ответы на основе актуальных источников."
    },
    {
      "role": "user",
      "content": "Какие последние достижения в области квантовых вычислений?"
    }
  ],
  "search": true,
  "temperature": 0.7,
  "max_tokens": 1000,
  "return_sources": true,
  "stream": false
}

Параметры запроса

Доступные модели

Perplexity AI предлагает несколько моделей, оптимизированных для различных задач:

Выбор модели

Примеры кода

Пример 1: Поиск новостей с источниками

import perplexity
import json

client = perplexity.Client(api_key="your-api-key")

def get_news_with_sources(topic):
    """Получить новости по теме с источниками"""
    
    response = client.chat.completions.create(
        model="pplx-70b-online",
        messages=[
            {
                "role": "user",
                "content": f"Найди последние новости на тему: {topic}. " +
                          "Предоставь краткое изложение и ссылки на источники."
            }
        ],
        search=True,
        return_sources=True,
        max_tokens=1500,
        temperature=0.8
    )
    
    message = response.choices[0].message
    
    result = {
        "answer": message.content,
        "sources": []
    }
    
    if hasattr(message, 'sources') and message.sources:
        for source in message.sources:
            result["sources"].append({
                "title": source.title if hasattr(source, 'title') else "Без названия",
                "url": source.url,
                "domain": source.domain if hasattr(source, 'domain') else None
            })
    
    return result

# Использование
news = get_news_with_sources("искусственный интеллект")
print("Ответ:", news["answer"])
print("\nИсточники:")
for source in news["sources"]:
    print(f"- {source['title']}: {source['url']}")

Пример 2: Сравнительный анализ

const { Perplexity } = require('perplexity-ai');

const client = new Perplexity({
    apiKey: process.env.PERPLEXITY_API_KEY
});

async function compareTechnologies(tech1, tech2) {
    // Запрос на сравнительный анализ
    const response = await client.chat.completions.create({
        model: 'llama-3-sonar-large-32k-online',
        messages: [
            {
                role: 'user',
                content: `Сравни технологии ${tech1} и ${tech2}. ` +
                        `Рассмотри следующие аспекты: производительность, ` +
                        `стоимость, экосистема, перспективы развития. ` +
                        `Предоставь структурированный ответ в формате JSON.`
            }
        ],
        search: true,
        return_sources: true,
        max_tokens: 2000
    });
    
    // Парсинг ответа
    const content = response.choices[0].message.content;
    
    // Извлечение JSON из ответа
    let jsonMatch = content.match(/```json\n([\s\S]*?)\n```/) || 
                    content.match(/{[\s\S]*}/);
    
    if (jsonMatch) {
        try {
            const jsonStr = jsonMatch[1] || jsonMatch[0];
            return JSON.parse(jsonStr);
        } catch (e) {
            console.warn('Не удалось распарсить JSON, возвращаем текст');
        }
    }
    
    return { comparison: content };
}

// Использование
compareTechnologies('React', 'Vue.js')
    .then(result => {
        console.log('Результат сравнения:', JSON.stringify(result, null, 2));
    })
    .catch(error => {
        console.error('Ошибка:', error);
    });

Пример 3: Потоковая передача ответов

import perplexity
import sys

client = perplexity.Client(api_key="your-api-key")

def stream_response(question):
    """Получить ответ с потоковой передачей"""
    
    stream = client.chat.completions.create(
        model="pplx-7b-online",
        messages=[{"role": "user", "content": question}],
        stream=True,
        search=True,
        max_tokens=1000
    )
    
    full_response = ""
    print("🤖: ", end="", flush=True)
    
    for chunk in stream:
        if chunk.choices[0].delta.content:
            content = chunk.choices[0].delta.content
            print(content, end="", flush=True)
            full_response += content
    
    print("\n")
    return full_response

# Использование
if __name__ == "__main__":
    question = "Объясни концепцию блокчейна простыми словами"
    response = stream_response(question)
    
    # Дополнительная обработка ответа
    print(f"Длина ответа: {len(response)} символов")

Лучшие практики

Оптимизация запросов

• Используйте поиск только когда нужно — отключайте search для общих знаний
• Кэшируйте частые запросы — особенно запросы к актуальным новостям
• Используйте потоковую передачу для лучшего UX в веб-приложениях
• Настройте таймауты — устанавливайте разумные таймауты для запросов (30-60 секунд)

Обработка ошибок

import perplexity
import time
from perplexity import APIError, RateLimitError

client = perplexity.Client(api_key="your-api-key")

def robust_perplexity_request(prompt, max_retries=3):
    """Устойчивый запрос к Perplexity API с повторными попытками"""
    
    for attempt in range(max_retries):
        try:
            response = client.chat.completions.create(
                model="pplx-7b-online",
                messages=[{"role": "user", "content": prompt}],
                search=True,
                max_tokens=1000
            )
            
            return response.choices[0].message.content
            
        except RateLimitError as e:
            wait_time = 2 ** attempt  # Экспоненциальная задержка
            print(f"Превышен лимит запросов. Ждем {wait_time} секунд...")
            time.sleep(wait_time)
            
        except APIError as e:
            if e.status_code == 500:
                print("Ошибка сервера. Повторяем попытку...")
                time.sleep(1)
                continue
            else:
                raise  # Повторяем только для временных ошибок
                
        except Exception as e:
            print(f"Неожиданная ошибка: {e}")
            if attempt == max_retries - 1:
                raise
    
    raise Exception("Не удалось получить ответ после всех попыток")

# Использование
try:
    answer = robust_perplexity_request("Что такое машинное обучение?")
    print(answer)
except Exception as e:
    print(f"Ошибка: {e}")

Частые вопросы (FAQ)

Вопрос: Чем Perplexity AI отличается от других языковых моделей?

Ответ: Perplexity AI отличается способностью искать актуальную информацию в интернете в реальном времени и предоставлять ответы с указанием источников. Это делает его идеальным для работы с быстро меняющейся информацией.

Вопрос: Как получить доступ к Perplexity API?

Ответ: Доступ к API предоставляется через веб-сайт Perplexity.ai. Зарегистрируйтесь, перейдите в настройки аккаунта и создайте API-ключ в соответствующем разделе.

Вопрос: Есть ли ограничения на использование API?

Ответ: Да, существуют ограничения на количество запросов в минуту (RPM) и общее количество токенов в месяц. Бесплатный план включает 100 запросов в день, платные планы предлагают более высокие лимиты.

Вопрос: Как правильно использовать параметр search?

Ответ: Используйте search: true для запросов, требующих актуальной информации (новости, последние данные). Для общих знаний и теоретических вопросов можно отключить поиск.

Вопрос: Можно ли использовать Perplexity API в коммерческих проектах?

Ответ: Да, Perplexity API можно использовать в коммерческих проектах в соответствии с условиями использования. Рекомендуется ознакомиться с тарифными планами и условиями лицензирования.