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

Ознакомьтесь с полями провайдеров ShareAI, значениями по умолчанию, ограничениями и ошибками для выбора исполнителей в запросах на инференс.

Просмотреть как Markdown

На этой странице

Необязательный provider объект находится на верхнем уровне запроса на инференс, рядом с model. Пустой объект использует значения по умолчанию. Он отделен от удаленного доступа провайдера и его учетных данных управления.

Поле	Тип	Поведение
`only`	массив тегов провайдеров	Ограничить выполнение этими провайдерами.
`ignore`	массив тегов провайдеров	Исключить этих провайдеров, включая резервный механизм.
`order`	массив тегов провайдеров	Расставить этих провайдеров первыми в указанном порядке; затем применить сортировку.
`allow_fallbacks`	boolean; значение по умолчанию true	Разрешить других подходящих провайдеров. При значении false и непустом списке порядка остаются только указанные провайдеры; без порядка остается только провайдер с наивысшим рейтингом.
`networks`	массив	Ограничить типы провайдеров до community, company и/или shareai.
`sort`	строка или объект	Использовать цену, задержку или пропускную способность, или объект с параметрами by и direction.

JSON

{
  "provider": {
    "ignore": [
      "PROVIDER_TO_EXCLUDE"
    ],
    "networks": [
      "company",
      "shareai"
    ],
    "sort": {
      "by": "throughput",
      "direction": "desc"
    },
    "allow_fallbacks": true
  }
}

Замените placeholder на реальный тег провайдера в нижнем регистре или удалите поле ignore. Типы сетей выбирают категории инфраструктуры; они не идентифицируют создателей моделей.

Сортировка по умолчанию#

Сортировать	Направление по умолчанию	Явное обратное направление
`price`	`asc` — сначала наименьшее	`desc` — сначала наибольшее
`latency`	`asc` — сначала наименьшее время выполнения	`desc` — сначала наибольшее время выполнения
`throughput`	`desc` — сначала наибольшее количество выходных токенов в секунду	`asc` — сначала наименьшее количество

Для объекта установите by одно из этих имен и direction к asc или desc. См. как работают измерения и резервный механизм.

Проверка и ошибки#

Используйте JSON-значения boolean и массивы тегов провайдеров в нижнем регистре. Не отправляйте null для провайдера или сортировки.
Принимаются только перечисленные поля; это не полная реализация параметров OpenRouter.
Политика ограничена 8 KiB. Списки only, ignore и order принимают не более 100 тегов каждый.
Неверные политики возвращают HTTP 400. Запрещенные области действия учетных данных возвращают HTTP 403. Отсутствие доступного подходящего провайдера возвращает HTTP 503.

Минимальная политика#

JSON

{
  "provider": {
    "sort": "price"
  }
}

При полном отсутствии выбор провайдера также по умолчанию осуществляется через детерминированную сортировку по возрастанию цены. Ограничения всегда применяются перед сортировкой.

Последнее обновление Сентябрь 16, 2026