Fijación de grupos

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

La fijación lo anula por modelo: eliges exactamente qué grupos puede usar y la facturación queda bloqueada a sus tarifas. Útil cuando necesitas la calidad o región de un proveedor concreto, o una tarifa que no debe moverse.

La página de detalle de cada modelo lista cada grupo con su precio de entrada y salida bajo Group Pricing; la insignia de descuento en la lista de modelos siempre 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 y marca uno o más grupos de proveedores, ordenados del más barato al más caro con su multiplicador de tarifa. Los modelos que no toques siguen en auto.

Los modelos fijados suben arriba con una insignia que muestra a cuántos grupos están bloqueados; Borrar todo devuelve la clave a auto completo. La lista de claves muestra las claves fijadas como auto +N.

Un modelo fijado solo se enruta dentro de sus grupos fijados: se prueba primero el más barato, con conmutación automática al siguiente ante errores o caídas. Se factura la tarifa del grupo que realmente sirvió la petición.

Una cabecera X-Group explícita en la petición sigue ganando a la fijación, y los modelos sin fijar mantienen el enrutamiento al más barato disponible.

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

Si todos los grupos fijados de un modelo están caídos mientras otros proveedores aún lo sirven, las peticiones fallan con un error específico en lugar de un mensaje genérico:

{
  "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 de la clave, o reintenta más tarde. El modelo en sí sigue funcionando.