Fijación de grupos

Cada modelo lo sirven uno o más grupos de proveedores, cada uno con su propio precio. Por defecto una clave usa auto: cada petición va al grupo activo más barato.

Fijarlo anula ese comportamiento por modelo. Tú eliges qué grupos puede usar y la facturación queda ligada a sus tarifas.

Cada página de modelo lista todos los grupos con su precio de entrada y salida en Group Pricing. La etiqueta de descuento de la lista de modelos refleja el grupo más barato.

Abre Claves API, crea o edita una clave y abre el selector de grupos. Busca un modelo, haz clic en él y marca uno o varios grupos, ordenados del más barato al más caro. Los modelos que no toques siguen en auto.

Los modelos fijados se ordenan arriba con una etiqueta que indica su número de grupos. Clear all devuelve la clave a auto. La lista de claves muestra las claves fijadas como auto +N.

Un modelo fijado se enruta solo dentro de sus grupos fijados, del más barato al más caro, con failover ante errores. El grupo que atiende la petición determina la tarifa facturada.

Combina una fijación con una vigilancia para enterarte cuando sus grupos cambien de precio o caigan, consulta Notificaciones

Para fijar una sola petición sin cambiar la clave, envía una cabecera X-Group con el nombre exacto del grupo. Anula la fijación de la clave y el enrutado auto. Copia los nombres desde Group Pricing.

curl https://api.unorouter.com/v1/chat/completions \
  -H "Authorization: Bearer $UNOROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Group: glm-new-pol-glm-5.2" \
  -d '{
    "model": "glm-5.2",
    "messages": [{ "role": "user", "content": "Hello" }]
  }'

La cabecera debe nombrar un grupo que la clave pueda usar o la petición se rechaza. Los modelos no fijados siguen con el enrutado más barato.

Si todos los grupos fijados están caídos mientras otros proveedores siguen sirviendo el modelo, las peticiones fallan con un error específico en lugar de un mensaje genérico de saturación:

{
  "error": {
    "message": "Your pinned provider groups for model \"glm-5.2\" are currently unavailable, but the model is still served by other providers. Edit this key's group override, or try again later.",
    "type": "new_api_error",
    "code": "get_channel_failed"
  }
}

Amplía o quita la fijación, o reinténtalo más tarde. El modelo en sí funciona.