mixgateway.io

Nombres de modelos y enrutamiento

1. Convención del campo model

La puerta de enlace usa una sola cadena model para identificar el proveedor y el modelo upstream, separados por dos puntos:

  • Formato: provider:modelId

Ejemplos:

  • Chat DeepSeek: deepseek:deepseek-chat
  • Id nativo del proveedor (si está soportado): deepseek-chat
  • Otro host con el mismo modelo lógico: AliyunBailian:deepseek-chat (ejemplo)
  • Razonamiento DeepSeek: deepseek:deepseek-reasoner
  • OpenAI GPT‑4.1 mini: openai:gpt-4.1-mini

Donde:

  • provider — Identificador interno, p. ej. deepseek, openai, siliconflow, AliyunBailian, etc.
  • modelId — Nombre del modelo según la documentación del proveedor, p. ej. deepseek-chat, deepseek-reasoner, gpt-4.1-mini.

A veces puede omitirse el prefijo provider:. Por ejemplo, solo deepseek-chat puede resolverse mediante el mapeo por defecto de la puerta de enlace.

2. Comportamiento de enrutamiento (transparente)

Al llamar POST https://api.mixgateway.io/v1/chat/completions:

  1. La puerta de enlace obtiene provider y modelId desde model (o aplica valores por defecto si solo envía modelId).
  2. Selecciona el endpoint upstream y las credenciales correctas.
  3. Antes de reenviar, puede reescribir model al id real del proveedor (p. ej. deepseek-chat) y añadir la autorización upstream adecuada.

No necesita mantener mapeos de proveedor en su aplicación. Si model es válido para su cuenta, la puerta de enlace enruta al proveedor y modelo previstos.

3. Ejemplo: migrar desde DeepSeek directo

Original (directo a DeepSeek):

curl https://api.deepseek.com/v1/chat/completions \
  -H "Authorization: Bearer {deepseek_api_key}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "messages": [{"role":"user","content":"Hi"}]
  }'

Vía mixgateway.io (mismo cuerpo, otra URL base y clave):

curl https://api.mixgateway.io/v1/chat/completions \
  -H "Authorization: Bearer {gateway_api_key}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "messages": [{"role":"user","content":"Hi"}]
  }'

Cambios habituales:

  • URL base — del host del proveedor a https://api.mixgateway.io/v1 (sin segmento de ruta más allá de /v1 si así expone su despliegue la API).
  • Authorization — de la clave del proveedor a la clave de la puerta de enlace en la [consola](/dashboard).

Campos como model, messages, temperature, max_tokens, etc. suelen permanecer iguales.

También puede usar un proveedor explícito:

"model": "deepseek:deepseek-chat"

4. Proveedores y modelos admitidos

  • Use la página pública de Precios del sitio para tarifas y listados de alto nivel.
  • En la [consola](/dashboard), confirme qué proveedores y valores modelId están habilitados para su cuenta y revise la facturación antes del tráfico de producción.

Ver también