Revendedores/Enrutamiento de proveedores

Elegir proveedores y su orden

Un mismo modelo puede ser atendido por varios proveedores; por ejemplo, deepseek-v4.1-flash puede ser atendido por deepseek, opencode o volcengine. De forma predeterminada, la plataforma elige un proveedor por prioridad y pasa al siguiente cuando uno no está disponible. El precio depende solo del modelo, nunca del proveedor que atiende la solicitud. Para controlarlo tú mismo, agrega un objeto provider al cuerpo de la solicitud.

En esta páginaexpand_more

Campos de provider
ID de proveedor
Ejemplos
Notas

Campos de providerlink

only

Usa solo los proveedores indicados, por ejemplo {"only": ["deepseek"]}.

ignore

Nunca usa los proveedores indicados, por ejemplo {"ignore": ["opencode"]}.

order

Prueba los proveedores indicados en este orden y pasa al siguiente cuando uno no está disponible. Los proveedores que no indiques siguen usándose al final como respaldo; para excluirlos, combina order con only o ignore.

ID de proveedorlink

provider solo importa en modelos con más de un proveedor. Los modelos cerrados como Claude, GPT, Gemini y Grok solo los sirve su proveedor oficial y no necesitan preferencia. Abajo se listan los ID de proveedor en uso hoy. Los proveedores que sirven un modelo concreto aparecen en la fila Proveedores de su página de detalle (en orden de prioridad predeterminado) y en el campo providers de GET https://wokey.ai/api/models.

ID de proveedor	Proveedor
deepseek	DeepSeek (oficial)
moonshot	Kimi (oficial, Moonshot AI)
zhipu	GLM (oficial, Zhipu)
minimax	MiniMax (oficial)
volcengine	Volcengine Ark: Doubao, además de algunos modelos de DeepSeek, GLM, Kimi y MiniMax
opencode	OpenCode Go: Tencent Hy4, además de algunos modelos de DeepSeek, GLM, Kimi y MiniMax
ollama	Ollama Cloud: algunos modelos de DeepSeek, GLM, Kimi y MiniMax

Ejemploslink

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"]
    }
  }'

Los SDK de Python de OpenAI y Anthropic rechazan argumentos de nivel superior desconocidos, así que pasa provider en 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)

Notaslink

/chat/completions, /responses y /messages lo aceptan de la misma forma.
Un ID de proveedor desconocido devuelve 400 invalid_request_error. Una preferencia que excluye a todos los proveedores del modelo devuelve 404 no_eligible_provider.
provider solo reduce las opciones. Se aplica junto con cualquier restricción de proveedor configurada en la clave de API y no puede volver a habilitar un proveedor que la clave excluye.
Para conservar la caché del prompt, una conversación que pasó a otro proveedor se queda ahí en lugar de volver al primer proveedor del orden.
provider es una directiva de enrutamiento para la plataforma y nunca se reenvía al upstream.