Реселлерам/Выбор поставщика

Выбор поставщиков и их порядка

Одну модель могут обслуживать несколько поставщиков: например, deepseek-v4.1-flash доступна через deepseek, opencode и volcengine. По умолчанию платформа выбирает поставщика по приоритету и переключается на следующего, если текущий недоступен. Цена зависит только от модели, а не от поставщика, который обработал запрос. Чтобы управлять выбором самостоятельно, добавьте в тело запроса объект provider.

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

Поля providerlink

only

Использовать только перечисленных поставщиков, например {"only": ["deepseek"]}.

ignore

Не использовать перечисленных поставщиков, например {"ignore": ["opencode"]}.

order

Пробовать поставщиков в указанном порядке, переходя к следующему, если текущий недоступен. Не перечисленные поставщики остаются в конце как запасной вариант; чтобы исключить их, используйте order вместе с only или ignore.

ID поставщиковlink

provider имеет смысл только для моделей с несколькими поставщиками. Закрытые модели, такие как Claude, GPT, Gemini и Grok, обслуживает только официальный поставщик, и указывать provider для них не нужно. Используемые сейчас идентификаторы поставщиков перечислены ниже. Какие поставщики обслуживают конкретную модель, показано в строке «Поставщики» на её странице (в порядке приоритета по умолчанию) и в поле providers ответа GET https://wokey.ai/api/models.

ID поставщикаПоставщик
deepseekDeepSeek (официальный)
moonshotKimi (официальный, Moonshot AI)
zhipuGLM (официальный, Zhipu)
minimaxMiniMax (официальный)
volcengineVolcengine Ark: Doubao, а также отдельные модели DeepSeek, GLM, Kimi и MiniMax
opencodeOpenCode Go: Tencent Hy4, а также отдельные модели DeepSeek, GLM, Kimi и MiniMax
ollamaOllama Cloud: отдельные модели DeepSeek, GLM, Kimi и MiniMax

Примерыlink

cURL
curl https://api.wokey.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [
      { "role": "user", "content": "Hello" }
    ],
    "provider": {
      "order": ["volcengine", "deepseek"],
      "ignore": ["opencode"]
    }
  }'

Python SDK OpenAI и Anthropic не принимают неизвестные параметры верхнего уровня, поэтому передавайте provider через extra_body.

Python
from openai import OpenAI

client = OpenAI(base_url="https://api.wokey.ai/v1", api_key="YOUR_API_KEY")

response = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "Hello"}],
    extra_body={"provider": {"only": ["deepseek"]}},
)
print(response.choices[0].message.content)

Примечанияlink

  • /chat/completions, /responses и /messages принимают его в одинаковом виде.
  • Неизвестный идентификатор поставщика возвращает 400 invalid_request_error. Если условия исключают всех поставщиков модели, возвращается 404 no_eligible_provider.
  • provider только сужает выбор: он действует вместе с ограничением поставщиков, заданным для API-ключа, и не может разрешить поставщика, исключённого ключом.
  • Чтобы сохранить кэш промпта, диалог, перешедший к другому поставщику, остаётся у него и не возвращается сразу к первому поставщику из order.
  • provider используется только для маршрутизации на платформе и никогда не передаётся вышестоящему сервису.