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

Polza.ai предоставляет доступ к моделям от разных провайдеров. В этом гайде вы узнаете, как выбирать оптимального провайдера для ваших задач.

Что такое провайдер?

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

Доступные провайдеры

OpenAI

GPT-4o, GPT-4o-mini, o3 и др.

Anthropic

Claude Sonnet, Claude Opus и др.

Google

Gemini Pro, Gemini Flash и др.

Meta*

Llama и др.

DeepSeek

DeepSeek V3, DeepSeek R1 и др.

Другие

Mistral, Qwen и др.

Как выбрать провайдера

Автоматический выбор (рекомендуется)

По умолчанию Polza.ai автоматически выбирает оптимального провайдера на основе доступности, скорости и стоимости. Не нужно передавать параметр provider — система сама определит лучший вариант.

// Автоматический выбор провайдера — ничего указывать не нужно
const completion = await openai.chat.completions.create({
  model: 'openai/gpt-4o',
  messages: [{ role: 'user', content: 'Привет!' }]
});

# Автоматический выбор провайдера — ничего указывать не нужно
completion = client.chat.completions.create(
    model="openai/gpt-4o",
    messages=[{"role": "user", "content": "Привет!"}]
)

Параметр `provider`

Для управления выбором провайдера передайте объект provider в запросе:

Поле	Тип	Описание
`order`	string[]	Приоритетный порядок провайдеров
`only`	string[]	Белый список — использовать только указанных провайдеров
`ignore`	string[]	Чёрный список — исключить указанных провайдеров
`sort`	string	Сортировка: `price`, `latency` или `throughput`
`max_price`	object	Максимальные цены (см. ниже)
`allow_fallbacks`	boolean	Разрешить фолбэк на другие провайдеры при ошибке

Поля `max_price`

Поле	Тип	Описание
`prompt`	number	Макс. цена за промпт (RUB за миллион токенов)
`completion`	number	Макс. цена за completion (RUB за миллион токенов)
`image`	number	Макс. цена за изображение (RUB)
`audio`	number	Макс. цена за аудио (RUB за миллион токенов)
`request`	number	Макс. цена за запрос (RUB)

Alias в строке `model`

Если ваш клиент не поддерживает дополнительные поля в body (например, некоторые OpenAI-совместимые SDK), часть routing-настроек можно передать прямо в строке model через @-синтаксис:

<model>@<key>=<value>&<key>=<value>

Поддерживаемые alias-параметры:

Alias	Что делает
`provider`	Выбирает конкретного провайдера (`provider.only`)
`reasoning_effort`	Управляет глубиной reasoning (`low` / `medium` / `high` и др.)
`allow_fallbacks`	Разрешает или запрещает fallback (`true` / `false`)

Примеры:

anthropic/claude-opus-4-6@provider=Amazon Bedrock
minimax/minimax-m2.5@reasoning_effort=high
minimax/minimax-m2.5@allow_fallbacks=false
minimax/minimax-m2.5@provider=DeepInfra&reasoning_effort=high&allow_fallbacks=false

Alias-формат работает только для /v1/chat/completions, /v1/responses и /v1/messages. Embeddings, audio и media не поддерживаются.

Если один и тот же параметр задан и в alias, и в body (например, reasoning_effort в строке model и reasoning.effort в теле запроса), API вернёт 400. Для сложного routing (order, ignore, max_price) используйте обычный body-контракт.

Подробнее: Алиасы параметров в model

Примеры

Приоритет провайдеров

Укажите предпочтительный порядок провайдеров. Если первый недоступен — запрос уйдёт ко второму.

const completion = await openai.chat.completions.create({
  model: 'openai/gpt-4o',
  messages: [{ role: 'user', content: 'Привет!' }],
  // @ts-ignore - расширенный параметр Polza.ai
  provider: {
    order: ['OpenAI', 'Anthropic'],
    allow_fallbacks: true
  }
});

completion = client.chat.completions.create(
    model="openai/gpt-4o",
    messages=[{"role": "user", "content": "Привет!"}],
    extra_body={
        "provider": {
            "order": ["OpenAI", "Anthropic"],
            "allow_fallbacks": True
        }
    }
)

curl -X POST "https://polza.ai/api/v1/chat/completions" \
  -H "Authorization: Bearer <POLZA_AI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "messages": [{"role": "user", "content": "Привет!"}],
    "provider": {
      "order": ["OpenAI", "Anthropic"],
      "allow_fallbacks": true
    }
  }'

Белый список (only)

Ограничьте запрос только указанными провайдерами:

const completion = await openai.chat.completions.create({
  model: 'openai/gpt-4o',
  messages: [{ role: 'user', content: 'Привет!' }],
  // @ts-ignore
  provider: {
    only: ['OpenAI']
  }
});

completion = client.chat.completions.create(
    model="openai/gpt-4o",
    messages=[{"role": "user", "content": "Привет!"}],
    extra_body={
        "provider": {
            "only": ["OpenAI"]
        }
    }
)

curl -X POST "https://polza.ai/api/v1/chat/completions" \
  -H "Authorization: Bearer <POLZA_AI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "messages": [{"role": "user", "content": "Привет!"}],
    "provider": {
      "only": ["OpenAI"]
    }
  }'

Чёрный список (ignore)

Исключите определённых провайдеров:

{
  "provider": {
    "ignore": ["DeepInfra", "Together"]
  }
}

Сортировка по цене / скорости

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

{
  "provider": {
    "sort": "latency"
  }
}

{
  "provider": {
    "sort": "throughput"
  }
}

Фильтрация по максимальной цене

Ограничьте стоимость запроса:

{
  "provider": {
    "sort": "price",
    "max_price": {
      "prompt": 10,
      "completion": 20
    }
  }
}

Комбинирование параметров

Все параметры можно комбинировать:

{
  "provider": {
    "only": ["OpenAI", "Anthropic"],
    "sort": "price",
    "max_price": {
      "prompt": 15,
      "completion": 30
    },
    "allow_fallbacks": true
  }
}

Получение информации о провайдере

В ответе API можно увидеть, какой провайдер обработал запрос:

{
  "id": "gen_123",
  "model": "openai/gpt-4o",
  "provider": "openai-direct",
  "choices": [...],
  "usage": {...}
}

Советы и лучшие практики

Используйте автовыбор для production

Автоматический выбор провайдера обеспечивает лучшую доступность и оптимальную цену. При недоступности одного провайдера система автоматически переключится на другой.

Используйте allow_fallbacks

При явном выборе провайдера включайте allow_fallbacks: true, чтобы запрос не упал при временной недоступности выбранного провайдера.

Тестируйте на разных провайдерах

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

Мониторьте затраты

Разные провайдеры имеют разные цены. Используйте статистику использования для контроля расходов.

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

Каталог моделей

Полный список доступных моделей

Алиасы параметров

Передача provider и reasoning_effort прямо в строке model

Статистика

Мониторинг использования и затрат

* Meta признана экстремистской организацией и запрещена в Российской Федерации.

Начало работы

Продвинутое

Генерация медиа

Интеграции

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

Что такое провайдер?

Доступные провайдеры

OpenAI

Anthropic

Google

Meta*

DeepSeek

Другие

Как выбрать провайдера

Автоматический выбор (рекомендуется)

Параметр `provider`

Поля `max_price`

Alias в строке `model`

Примеры

Приоритет провайдеров

Белый список (only)

Чёрный список (ignore)

Сортировка по цене / скорости

Фильтрация по максимальной цене

Комбинирование параметров

Получение информации о провайдере

Советы и лучшие практики

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

Каталог моделей

Алиасы параметров

Статистика

​Что такое провайдер?

​Доступные провайдеры

OpenAI

Anthropic

Google

Meta*

DeepSeek

Другие

​Как выбрать провайдера

​Автоматический выбор (рекомендуется)

​Параметр provider

​Поля max_price

​Alias в строке model

​Примеры

​Приоритет провайдеров

​Белый список (only)

​Чёрный список (ignore)

​Сортировка по цене / скорости

​Фильтрация по максимальной цене

​Комбинирование параметров

​Получение информации о провайдере

​Советы и лучшие практики

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

Каталог моделей

Алиасы параметров

Статистика

Что такое провайдер?

Доступные провайдеры

Как выбрать провайдера

Автоматический выбор (рекомендуется)

Параметр `provider`

Поля `max_price`

Alias в строке `model`

Примеры

Приоритет провайдеров

Белый список (only)

Чёрный список (ignore)

Сортировка по цене / скорости

Фильтрация по максимальной цене

Комбинирование параметров

Получение информации о провайдере

Советы и лучшие практики

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