Как начать работу с API Polza.AI: полное руководство

Что такое Polza.AI API

Polza.AI — это единая точка доступа к сотням AI-моделей через один OpenAI-совместимый API. Вместо того чтобы регистрироваться у десятков провайдеров и хранить множество ключей, вы получаете один API-ключ и доступ ко всему.

Шаг 1: Получение API-ключа

Зарегистрируйтесь на polza.ai и перейдите в раздел API ключи. Нажмите «Создать ключ», дайте ему понятное название — например, production или my-app.

⚠️ Сохраните ключ сразу — он показывается только один раз. Если потеряете, придётся создать новый.

Шаг 2: Первый запрос

API полностью совместим с OpenAI SDK. Просто укажите другой base_url:

from openai import OpenAI

client = OpenAI(
    api_key="ваш_ключ_polza_ai",
    base_url="https://api.polza.ai/v1"
)

response = client.chat.completions.create(
    model="anthropic/claude-sonnet-4-6",
    messages=[
        {"role": "user", "content": "Привет! Как дела?"}
    ]
)

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

Шаг 3: Выбор модели

Все доступные модели можно посмотреть через эндпоинт /v1/models или на сайте в разделе «Модели». Модели сгруппированы по типу:

• chat — текстовые диалоги (Claude, GPT, Gemini, Llama)
• image — генерация изображений (DALL-E, Stable Diffusion, Flux)
• embedding — векторные представления текста
• tts / stt — синтез и распознавание речи

Шаг 4: Работа с параметрами

Все стандартные параметры OpenAI поддерживаются:

response = client.chat.completions.create(
    model="google/gemini-2.0-flash",
    messages=[{"role": "user", "content": "Напиши хайку о программировании"}],
    temperature=0.7,
    max_tokens=200,
    stream=True  # потоковый режим
)

for chunk in response:
    print(chunk.choices[0].delta.content, end="", flush=True)

Шаг 5: Обработка ошибок

Основные коды ошибок, которые стоит обрабатывать:

Что дальше?

Теперь вы готовы к работе. Изучите раздел «Модели» чтобы найти лучшую модель для вашей задачи, или почитайте про потоковую передачу данных и мультимодальность.