Skip to main content
У части моделей в каталоге Polza.ai есть провайдеры с бейджем «Неофициальный». Здесь объясняем, что это значит и как их включить или выключить.

​
Что такое неофициальный провайдер

Официальный провайдер — это API самого разработчика модели или его облачного партнёра: OpenAI, Anthropic, Google, Яндекс и другие. Неофициальный провайдер даёт доступ к той же модели через сторонний шлюз: он покупает доступ к модели у разработчика по своим условиям и перепродаёт его через свой API. Поэтому такие провайдеры обычно дешевле.

​
Какие есть риски

Polza.ai выбирает неофициальных провайдеров, которые не сохраняют запросы и не используют данные клиентов. Но проверить это так же надёжно, как у официального API, мы не можем. Поэтому риски остаются:
  • Данные. Запрос проходит через серверы ещё одной компании. Мы не можем гарантировать, что она не сохраняет и не читает запросы.
  • Стабильность. Разработчик модели может в любой момент закрыть такой доступ — провайдер перестанет отвечать без предупреждения.
  • Поведение. Ответы могут немного отличаться от официального API: другие лимиты, другие версии модели.

​
Как это работает в Polza.ai

По умолчанию неофициальные провайдеры выключены. Запросы к ним не уходят, пока вы сами их не разрешите.
  • Если у модели есть и официальный, и неофициальный провайдер, запрос уйдёт к официальному.
  • Если модель доступна только через неофициальных провайдеров, API ответит ошибкой 403 с кодом unofficial_providers_disabled.
  • Параметр provider.only этот запрет не обходит.
  • В списке моделей GET /v1/models с API-ключом без разрешения неофициальных провайдеров нет, а модели только на них скрыты.
Разрешили — неофициальные провайдеры участвуют в выборе наравне с остальными: по цене, приоритету и доступности.

​
Как включить

​
Для API-ключа

В консоли откройте API-ключи, создайте ключ или откройте настройки существующего и включите «Неофициальные провайдеры». Разрешение действует только на этот ключ.
  • Через API — поле allowUnofficialProviders при создании или изменении ключа.

​
Для Нейростудии

В Нейростудии нет API-ключа, поэтому разрешение — настройка вашего пользователя. Откройте Настройки справа и включите «Неофициальные провайдеры» внизу панели. Настройка действует во всех ваших организациях и не сбрасывается кнопкой «Сбросить настройки».

​
Как узнать, что провайдер неофициальный

  • В каталоге моделей у такого провайдера бейдж «Неофициальный».
  • В GET /v1/models?include_providers=true у провайдера поле is_unofficial: true.

​
Ошибка unofficial_providers_disabled

Что сделать: разрешить неофициальных провайдеров для ключа или в Нейростудии либо выбрать другую модель. Деньги за такой запрос не списываются: он отклоняется до обращения к провайдеру.

​
Следующие шаги

Выбор провайдера

Приоритет, белый и чёрный списки провайдеров, сортировка по цене

Список моделей

Как получить каталог моделей с провайдерами через API

GET Models

Справочник эндпоинта со списком моделей