Conmutación Automática — Documentación de TokSpan

Cómo Funciona

TokSpan monitorea la salud de los proveedores upstream en tiempo real. Cuando un proveedor devuelve errores 5xx repetidos o excede un umbral de tiempo de espera, el tráfico se redirige automáticamente al siguiente proveedor en tu cadena de conmutación. Una vez que el primario se recupera, el tráfico reanuda el enrutamiento normal.

La cadena de conmutación por error se configura automáticamente en TokSpan entre nuestros proveedores upstream. No se requiere configuración de tu parte: solo sigues usando el mismo nombre de modelo.

No se requiere configuración. La conmutación por error está habilitada automáticamente en todos los modelos: no hay nada que configurar en tu panel y tu código permanece exactamente igual.

Cómo TokSpan Construye Tu Cadena de Failover

Para cada modelo, TokSpan mantiene una cadena de conmutación entre varios proveedores que sirven el mismo modelo. Si el proveedor principal falla, el tráfico fluye al siguiente proveedor saludable de ese mismo modelo — sin que tengas que hacer nada.

Prioridad	Modelo	Proveedor	Cómo Se Usa
1 (Primario)	GPT series	OpenAI	Opción principal — mejor calidad general
2 (Respaldo)	GPT series	other model providers	Ruta de respaldo para el mismo modelo

Enrutamiento del mismo modelo: Cuando falla la ruta principal, TokSpan cambia a una ruta de respaldo del mismo modelo (p. ej., otro proveedor que sirva la serie GPT). La conmutación nunca cruza a un modelo diferente — tu salida se mantiene consistente mientras las caídas de proveedor se gestionan automáticamente.

Monitoreando Eventos de Conmutación

Puedes rastrear la actividad de conmutación a través de:

Registros del panel — Consulta tu historial de solicitudes para confirmar que el tráfico cambió al proveedor de respaldo
Webhooks — Configura notificaciones en tiempo real en tu cuenta (consulta Webhooks)
Analíticas de uso — Los picos de uso por modelo indican actividad de conmutación