Тайм-аут и размеры
Запрос живёт до 600 секунд. Файл и изображение в хранилище — до 50 МБ. Ограничения по числу запросов в минуту нигде не опубликованы, поэтому перед большой нагрузкой их приходится измерять самостоятельно.
API Polza AI
Единый REST-интерфейс к 392 моделям, совместимый со стандартом OpenAI Chat Completions. Готовый код на OpenAI SDK переезжает сменой базового адреса, а клиент, формат ответа и потоковая передача остаются прежними.
Заведите ключ
Регистрация по почте на polza.ai, дальше личный кабинет и раздел API-ключей. Ключ начинается с pza_ и передаётся обычным заголовком авторизации.
заголовок запроса
Authorization: Bearer pza_ваш-ключСмените базовый адрес
Для OpenAI SDK подставляется адрес с версией. Всё остальное в клиенте остаётся как было.
python, openai sdk
from openai import OpenAI
client = OpenAI(
api_key="pza_ваш-ключ",
base_url="https://polza.ai/api/v1"
)Назовите модель в запросе
Идентификатор берётся из каталога и выглядит как «разработчик/модель». Сменить модель — значит поменять эту строку, ключ и адрес не трогаются.
curl
curl https://polza.ai/api/v1/chat/completions \
-H "Authorization: Bearer pza_ваш-ключ" \
-H "Content-Type: application/json" \
-d '{
"model": "anthropic/claude-sonnet-5",
"messages": [{"role": "user", "content": "Привет"}],
"stream": true
}'Эндпоинты
Кроме текста, тем же ключом доступны картинки, видео, речь и векторы. Базовый адрес у всех один — https://polza.ai/api.
| Адрес | Что делает |
|---|---|
/chat/completions | Текст и код по спецификации OpenAI, с потоковой передачей через Server-Sent Events |
/api/v1/images/generations | Генерация изображений |
/api/v1/videos/generations | Генерация видео, результат забирается через media status |
/api/v1/audio/transcriptions | Расшифровка речи |
/api/v1/audio/translations | Перевод речи |
/api/v1/audio/speech | Синтез речи |
/api/v1/embeddings | Векторы для поиска и RAG |
/api/v1/models | Каталог целиком, отдаётся без ключа |
/api/v1/balance | Остаток на счёте |
Ограничения и коды ответов
Что означают ошибки
402 — на балансе не хватает денег. 429 — превышен лимит запросов. 502 — площадка модели недоступна. 503 — свободных площадок нет вовсе.
Дополнительные параметры
Вызов инструментов, структурированный вывод, веб-поиск для любой модели, токены рассуждения. Провайдера, глубину рассуждения и разрешение на переключение можно задавать прямо в поле модели.
Что сохраняется
По умолчанию только метаданные: время, модель и число токенов. Содержимое запросов и ответов не хранится и на обучении моделей не используется. Логирование включается вручную при создании ключа, логи живут 30 дней.