Descubrimiento de modelos

Use la página de Modelos o la API de Modelos para inspeccionar los modelos de texto disponibles. Los metadatos del modelo incluyen proveedor, proveedor de servicio, modalidad, longitud de contexto, familias de API soportadas, capacidades soportadas, disponibilidad, límites a nivel de cuenta y precios en créditos.

Endpoint: GET /v1/models Propósito: Listar los modelos disponibles para la cuenta actual.

Copiarcurl --request GET \
  --url https://api.basicrouter.ai/api/v1/models \
  --header "Authorization: Bearer $BASICROUTER_API_KEY"

Matriz de capacidades

Matriz de compatibilidad de familias de API

Autenticación

Cada solicitud API usa un token bearer. Guarde las claves en variables de entorno del lado del servidor, rótelas cuando cambie el acceso del equipo y registre los IDs de solicitud para depuración.

Recomendaciones de seguridad de claves

1. Mantenga las claves API en el servidor. No exponga las claves en código de cliente del navegador o móvil.
2. Use claves separadas para desarrollo, staging, producción e integraciones de terceros.
3. Limite las claves por entorno, servicio, cliente o inquilino cuando esté disponible.
4. Rote las claves tras la salida de empleados, cambios de acceso de proveedores o sospecha de fuga.
5. Guarde las claves en gestores de secretos o variables de entorno, no en código fuente.

Uso de la Consola

La Consola de BasicRouter es el plano de control operativo para el acceso API, la disponibilidad de modelos, las políticas de enrutamiento, la visibilidad de uso y la administración de facturación. Ofrece a los administradores de cuenta una vista centralizada de claves, modelos, solicitudes, créditos y controles a nivel de cuenta para el tráfico de modelos en producción.

Gestión de claves API

Cree, rote, revoque y etiquete claves API desde la consola. Use claves separadas para desarrollo, staging, producción y servicios individuales para que el uso pueda ser auditado y aislado por entorno o aplicación.

Lista de modelos

Use la página de Modelos para revisar los modelos disponibles para la cuenta. Cada entrada de modelo puede incluir proveedor, proveedor de servicio, modalidad, familias de API soportadas, longitud de contexto, indicadores de capacidad, estado de disponibilidad e información de precios.

Para aplicaciones en producción, verifique las capacidades del modelo antes de habilitar el tráfico. Algunos parámetros y características dependen del modelo y pueden no estar soportados en todas las familias de API.

Uso y registros

La vista de Uso y Registros proporciona visibilidad operativa del tráfico API. Los equipos pueden inspeccionar el volumen de solicitudes, los modelos seleccionados, los destinos de enrutamiento resueltos, el consumo de créditos, la latencia, los códigos de error y los IDs de solicitud.

• Solucionar solicitudes fallidas.
• Identificar cargas de trabajo de alto costo.
• Comparar el uso de modelos entre aplicaciones y entornos.
• Validar el comportamiento de enrutamiento y respaldo.
• Investigar problemas de latencia o disponibilidad del proveedor.
• Proporcionar IDs de solicitud al contactar con soporte.

Cada respuesta API incluye o expone un ID de solicitud de BasicRouter. Guarde este ID en los registros de su aplicación para hacer que la depuración en producción y la escalada de soporte sean más eficientes.

Respaldo

El respaldo es el mecanismo de resiliencia de BasicRouter. Cuando el modelo principal o la política de enrutamiento falla, el sistema cambia automáticamente a un modelo de respaldo para seguir procesando la solicitud. Esto mantiene su aplicación receptiva y minimiza el riesgo de interrupción del servicio.

Por qué importa el respaldo

En producción, los servicios de modelos pueden encontrar varios problemas impredecibles:

• Falla del servicio de modelo: la API de origen queda temporalmente no disponible o se agota el tiempo de espera.
• Fluctuación de rendimiento: una alta carga del modelo provoca respuestas lentas o fallidas.
• Falla de enrutamiento: todos los modelos candidatos seleccionados por el enrutamiento inteligente quedan no disponibles.

El respaldo mantiene su aplicación disponible proporcionando una ruta de respaldo confiable.

Ventajas principales

Configuración global de modelo de respaldo

BasicRouter permite configurar un modelo de respaldo global desde el backend de la consola. Todas las solicitudes usan automáticamente este modelo como respaldo cuando fallan.

Cómo configurarlo:

1. Vaya a la página de configuración de estrategia de BasicRouter.
2. Busque el ajuste Modelo de respaldo predeterminado.
3. Seleccione su modelo de respaldo global de la lista desplegable.
4. Guarde el ajuste para aplicarlo inmediatamente.

Ventajas de la configuración global:

• Sin cambios en el código: configure una vez y se aplica globalmente, sin necesidad de repetir el ajuste en cada solicitud.
• Gestión centralizada: administre la política de respaldo en un solo lugar para facilitar el ajuste y monitoreo.
• Mantenimiento simplificado: reduce la complejidad del código y la posibilidad de errores de configuración.
• Reemplazo flexible: la configuración de respaldo a nivel de solicitud tiene prioridad y puede anular el ajuste global para escenarios específicos.

Configuración de respaldo a nivel de solicitud

Para escenarios de negocio específicos, puede especificar un modelo de respaldo en una solicitud individual para anular la configuración global.

Especifique el modelo de respaldo con el parámetro router.fallBackModels:

Copiar{
  "model": "claude-sonnet-4",
  "messages": [
    {
      "role": "user",
      "content": "Explain what quantum computing is"
    }
  ],
  "router": {
    "fallBackModels": ["glm-5.2"]
  }
}

Reglas de prioridad

Cuando hay múltiples configuraciones de respaldo, la prioridad va de mayor a menor:

1. router.fallBackModels a nivel de solicitud: el modelo de respaldo especificado en una solicitud individual.
2. Modelo de respaldo predeterminado global: el modelo de respaldo global configurado en la consola.
3. Sin respaldo: si no se configura ninguno, la solicitud devuelve un error al fallar.

Administración de cuenta

Dependiendo del tipo de cuenta, la consola puede incluir habilitación de modelos a nivel de cuenta, controles de revendedor o distribuidor, configuración de facturación y ajustes de acceso. Los administradores pueden usar estos controles para alinear el acceso a modelos, la visibilidad de uso y la responsabilidad de facturación con aplicaciones, cuentas de cliente o unidades de negocio.

Lista de verificación de operaciones de producción

Facturación y créditos

BasicRouter usa un modelo de facturación basado en créditos para cargas de trabajo de texto, imagen, video y otros modelos soportados. Los créditos proporcionan una unidad unificada para el uso de múltiples modelos y proveedores, de modo que los equipos puedan gestionar el consumo de manera consistente entre modalidades y familias de API.

Los precios detallados de los modelos están disponibles en la página de Modelos o a través de las APIs de metadatos de modelos. Los precios pueden variar según el modelo, proveedor, modalidad, resolución, tipo de token, longitud de salida, duración de la tarea, tipo de cuenta y acuerdo comercial.

Recargar y monedero

Las cuentas pueden añadir créditos de monedero de pago por uso para un uso flexible. Los créditos del monedero se usan después de que se hayan consumido los créditos del plan mensual y los paquetes de recursos, a menos que se aplique una regla de facturación personalizada a la cuenta.

Los créditos del monedero no expiran a menos que se especifique lo contrario en los términos comerciales aplicables. Se cobra una tarifa de servicio al recargar el monedero de pago por uso.

Planes mensuales y paquetes de recursos

Cada usuario o cuenta puede seleccionar un plan mensual activo. Los planes mensuales proporcionan una cantidad definida de capacidad de uso, términos comerciales y configuración de acceso a nivel de cuenta para el período de facturación.

Los usuarios también pueden comprar múltiples paquetes de recursos para capacidad de uso adicional. Los paquetes de recursos pueden separar el uso comprometido del saldo del monedero de pago por uso y son útiles para uso intensivo de texto, imagen, video o cargas de trabajo dedicadas.

Orden de deducción

A menos que se configuren reglas de facturación personalizadas, los créditos se deducen en el siguiente orden:

Para cuentas con términos comerciales personalizados, el orden de deducción, las reglas de expiración, el uso incluido y los precios pueden diferir. Las reglas específicas de cuenta se muestran en la consola o se proporcionan a través del acuerdo comercial.

Precios personalizados

Los precios pueden personalizarse para cada usuario o cuenta. Los clientes empresariales, las cuentas de revendedor, las cuentas de distribuidor y los clientes de alto volumen pueden ser elegibles para precios personalizados. Contacte con ventas para obtener una cotización.

Los precios personalizados pueden configurarse por cuenta, modelo, proveedor, modalidad, región, volumen de uso o acuerdo comercial. Cuando se habilitan precios personalizados, la consola y las APIs de facturación reflejan los precios y reglas de deducción específicos de la cuenta cuando estén disponibles.

Unidades de precio

Diferentes modalidades de modelo usan diferentes unidades de medida. BasicRouter convierte estas unidades en créditos según las reglas de precios del modelo.

Las unidades de precio pueden variar según el modelo. Consulte siempre la página de detalles del modelo o los metadatos de precios antes de habilitar un modelo en producción.

Atribución de uso

El uso de BasicRouter puede revisarse por cuenta, clave API, modelo, modalidad o rango de tiempo. Esto permite a los equipos atribuir costos a aplicaciones, entornos, clientes o unidades de negocio internas.

Saldo de créditos

Verifique cuántos créditos están disponibles en su cuenta. El saldo se divide en tres monederos que se deducen en orden: la asignación del plan mensual, los paquetes de recursos comprados y el monedero de pago por uso. También está disponible un total combinado de recursos (plan mensual + paquetes de recursos, excluyendo pago por uso) para rastrear el uso incluido separadamente del gasto de recarga.

Para obtener esto mediante programación, consulte GET /v1/billing/balance en la Referencia API.

Detalles de uso

Revise una lista paginada y cronológica de registros de uso individuales para reportes, monitoreo y asignación interna de costos. Cada registro muestra el modelo, el tipo de modelo (texto, imagen o video), los créditos deducidos y un desglose de qué monedero se usó para cada deducción. Los resultados pueden filtrarse a un rango de tiempo específico.

Para obtener esto mediante programación, consulte GET /v1/usage en la Referencia API.

Historial de transacciones

Use el historial de transacciones para revisar movimientos de créditos, incluyendo recargas, asignaciones de planes, concesiones de paquetes de recursos, deducciones de uso, ajustes y correcciones administrativas.

Para obtener esto mediante programación, consulte GET /v1/billing/transactions en la Referencia API.

Solicitudes fallidas y reembolsos

Los errores de validación, los errores de autenticación y los errores de permisos generalmente no se facturan porque no ocurre ejecución del modelo. Las solicitudes que llegan a un modelo de origen o que generan salida parcial pueden consumir créditos dependiendo del modelo, el proveedor y el estado de la respuesta.

Para tareas asíncronas de imagen y video, el comportamiento de facturación depende de si la tarea fue aceptada, iniciada, completada, fallida o cancelada. La respuesta de detalle de la tarea incluye información de uso cuando se han consumido créditos.

Las recargas, los planes mensuales, los paquetes de recursos y los créditos consumidos no son reembolsables a menos que se especifique lo contrario en el acuerdo comercial aplicable o lo exija la ley.

Operativo

Errores

BasicRouter devuelve códigos de error estables para que las aplicaciones puedan manejar reintentos, respaldos, problemas de facturación y depuración de forma consistente.

Los endpoints compatibles con proveedores intentan preservar la forma de error de la familia de API original cuando es posible. Los endpoints nativos de BasicRouter usan el objeto de error de BasicRouter.

Mapeo de estados HTTP y códigos de error

Códigos de error comunes