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

URL: https://polza.ai/blog/kak-nachat-rabotu-s-api-polza-ai
Автор: Команда Polza.AI
Опубликовано: 2025-01-15
Обновлено: 2026-10-13
Категории: Руководства, API
Теги: быстрый старт, api, openai, python, sdk

> Пошаговое руководство по подключению к API Polza.AI: получение ключа, первый запрос, работа с моделями и обработка ответов. Всё что нужно знать разработчику для быстрого старта.

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

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

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

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

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

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

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

from openai import OpenAI

client = OpenAI(
    apikey="вашключpolzaai",
    baseurl="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,
    maxtokens=200,
    stream=True  # потоковый режим
)

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

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

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

  Код   Причина   Решение  

  401   Невалидный ключ   Проверьте ключ  
  402   Недостаточно средств   Пополните баланс  
  429   Превышен лимит   Добавьте retry с backoff  
  502   Провайдер недоступен   Попробуйте другую модель  

Что дальше?

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