Jev через Polza.AI: пошаговое подключение из России

Что понадобится

• электронная почта для регистрации;
• карта российского банка или СБП. Для ООО и ИП есть оплата по счёту с договором, УПД и НДС;
• curl для первой проверки, а для кода — Python или Node.js версии 20 и новее.

Аккаунт TypeSafe, заявка в лист ожидания, VPN и зарубежная карта не нужны. Сравнение Polza.AI с другими способами доступа есть в статье о Jev в России.

Шаг 1. Регистрация

Зарегистрируйтесь на polza.ai по электронной почте. Один аккаунт даёт доступ ко всему каталогу: по данным Polza, это Jev и больше 400 других моделей на одном ключе и одном балансе.

Шаг 2. Пополнение баланса

Пополнить баланс можно картой РФ или через СБП. Юрлица и ИП платят по счёту и получают закрывающие документы.

По данным Polza, бесплатного тарифа, пробного периода и подписки нет. Вы платите только за входные токены: текст в state и формулировки вопросов. Выходные токены бесплатны.

На 21 сентября 2026 года каталог Polza показывал цену 17,64 ₽ за 1 млн входных токенов. Цена меняется, поэтому перед расчётом бюджета проверьте страницу модели в каталоге. При такой цене 10 000 запросов по 600 токенов (6 млн токенов) стоят около 106 ₽. Это расчёт для примера, у вас размер запросов будет другим.

На стоимость влияют три вещи:

• Служебные токены. К каждому запросу провайдер добавляет около 280 входных токенов. На коротких текстах это заметная доля счёта.
• Число запросов. Десять вопросов одним запросом дешевле десяти запросов по одному вопросу: текст и служебная часть оплачиваются один раз.
• Язык. Русский текст занимает больше токенов, чем английский той же длины.

Посчитать расходы под свой объём поможет калькулятор стоимости, а сравнить цены площадок — статья о ценах Jev.

Шаг 3. API-ключ

Ключ создаётся в личном кабинете, в разделе «API-ключи». Сохраните его в переменной окружения, а не в коде:

export POLZA_AI_API_KEY="ваш_ключ_polza"

Тот же ключ работает со всеми моделями каталога. Для продакшена удобнее завести отдельный ключ под проект с Jev: при утечке его можно отозвать, не останавливая другие проекты.

Шаг 4. Первый запрос

Проверьте ключ запросом из документации Polza:

curl -X POST "https://polza.ai/api/v1/systemone" \
  -H "Authorization: Bearer $POLZA_AI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "typesafe/jev",
    "state": "Кроссовки пришли не того размера. Можно обменять на 43-й? Это срочно, у меня соревнования в субботу.",
    "questions": {
      "is_urgent": {
        "type": "noul",
        "instructions": "Клиент сообщает о срочной проблеме?"
      },
      "department": {
        "type": "choice",
        "instructions": "Какая команда должна заняться обращением?",
        "criteria": {
          "returns": "Обмен, возврат, не тот или повреждённый товар",
          "shipping": "Статус доставки, задержки, потерянные посылки",
          "billing": "Списания, счета, проблемы с оплатой",
          "other": "Ничего из перечисленного"
        }
      }
    }
  }'

Ответ, который приводит Polza:

{
  "model": "jev-1.13.0",
  "answers": {
    "is_urgent": { "type": "noul", "noul": 0.97 },
    "department": {
      "type": "choice",
      "choice": "returns",
      "confidence": 1.0,
      "probabilities": { "returns": 1.0, "shipping": 0.0, "billing": 0.0, "other": 0.0 }
    }
  },
  "usage": { "input_tokens": 548, "output_tokens": 64, "cost_rub": 0.0115 }
}

Формат тот же, что у API TypeSafe, плюс поле usage.cost_rub со стоимостью запроса в рублях. Вопросы и критерии можно писать по-русски.

Кроме typesafe/jev, Polza принимает идентификаторы jev-latest, jev-preview и jev-1.13.0. Имейте в виду, что typesafe/jev и jev-latest указывают на последнюю стабильную версию и переедут на новую, когда она выйдет. Версия, которая ответила, приходит в поле model. Логируйте её, если подбирали пороги под конкретную версию.

Шаг 5. Официальные SDK TypeSafe

API Polza совместим с официальными SDK TypeSafe. Меняются три вещи: адрес без /v1 (SDK допишет путь сам), ключ и модель.

Python:

import os

from typesafe_sdk import Noul, TypeSafeClient

client = TypeSafeClient(
    base_url="https://polza.ai/api",
    api_key=os.environ["POLZA_AI_API_KEY"],
    model="typesafe/jev",
)

result = client.system_one(
    "Кроссовки пришли не того размера. Можно обменять?",
    {"exchange": Noul(instructions="Клиент просит обмен или возврат?")},
)
print(result.nouls["exchange"].noul)

TypeScript:

import { TypeSafeClient, noul } from "@typesafe-ai/sdk";

const client = new TypeSafeClient({
  baseURL: "https://polza.ai/api",
  apiKey: process.env.POLZA_AI_API_KEY,
  defaultModel: "typesafe/jev",
});

const response = await client.systemOne({
  state: "Кроссовки пришли не того размера. Можно обменять?",
  questions: { exchange: noul("Клиент просит обмен или возврат?") },
});
console.log(response.answers.exchange.noul);

Настройки можно вынести и в переменные окружения. Оба SDK читают TYPESAFE_BASE_URL, TYPESAFE_API_KEY и TYPESAFE_DEFAULT_MODEL, поэтому переход между TypeSafe и Polza не требует правки кода:

export TYPESAFE_BASE_URL="https://polza.ai/api"
export TYPESAFE_API_KEY="$POLZA_AI_API_KEY"
export TYPESAFE_DEFAULT_MODEL="typesafe/jev"

Одна тонкость: по данным Polza, Python SDK отбрасывает поле cost_rub, а в TypeScript SDK и в HTTP-ответе оно есть. В Python стоимость можно достать из сырого ответа: result.raw_http_response.json()["usage"].get("cost_rub"). Остальные возможности SDK описаны в статьях о Python SDK и о JavaScript SDK.

Лимиты

Параметр	Значение
Текст в state	До 400 000 символов на стороне Polza
Вопросы	От 1 до 256 в одном запросе
Контекст модели	32 000 токенов на state и самый длинный вопрос, 64 000 на всё вместе
Варианты в choice	До 255
Уровни в score	От 2 до 10
Вход	Только текст: строка, объект или массив

Ошибки: чем Polza отличается от TypeSafe

Код	Когда
400	Запрос не прошёл проверку (у TypeSafe это 422), превышен контекст модели или модель не поддерживает эту ручку
401	Неверный API-ключ
402	Недостаточно средств на балансе (insufficient_balance)
429	Превышен лимит запросов, SDK TypeSafe повторят запрос сами
503	Провайдер недоступен или перегружен

Ошибка приходит в формате Polza: error.code, error.message и trace_id. Исходная ошибка TypeSafe с полями error_type и message дублируется в detail. SDK TypeSafe повторяют 429 и 503, а вот 402 не повторяют: нужно пополнить баланс. Остальные коды разобраны в статье об ошибках API Jev.

Данные и 152-ФЗ

Polza передаёт запросы в TypeSafe. По данным Polza, сервис TypeSafe размещён в одном регионе на западном побережье США, а сама Polza не сохраняет и не логирует тексты запросов и ответов. Данные при этом всё равно уходят за рубеж, поэтому персональные данные граждан РФ перед отправкой обезличивайте. Подробнее о правовой стороне — в статье о Jev в России.

Polza или TypeSafe напрямую

Сравнение по данным Polza:

	TypeSafe напрямую	Polza.AI
Доступ	Ранний доступ по листу ожидания	Ключ сразу после регистрации
Оплата	В долларах	В рублях: карта РФ, СБП, счёт
Документы	Зарубежный поставщик	Договор, счёт, УПД, НДС
Поддержка	На английском: Discord и почта	На русском: Telegram и почта
Другие модели	Только Jev	Больше 400 моделей на одном балансе

Модель в обоих случаях одна и та же. Разница в оплате, документах и сетевой задержке: посредник добавляет ещё одно звено между вашим кодом и моделью. Если важны миллисекунды, замерьте время ответа на своих данных.