Claves de API, cuota y uso
Grupos de claves, límites de cuota, restricciones de modelos e IP y vencimiento, además de registros y estadísticas de uso.
Esta página cubre la configuración de las claves de API, cómo se contabiliza la cuota de LLM y cómo hacer un seguimiento del uso mediante registros y estadísticas.
Cómo funciona la cuota
- Cuota de la cuenta: al activar LLM API, obtiene una cuenta de LLM independiente, de la que se deducen los cargos de los modelos. Se administra por separado del saldo de su cuenta principal. Puede añadir fondos mediante una transferencia o un código de canje. En Resumen de la cuenta, Saldo actual muestra lo que queda y Consumo histórico muestra el gasto acumulado.
- Importes mostrados: la consola muestra la cuota como un importe en dólares estadounidenses. Cuando introduce un valor de cuota sin procesar en la configuración de una clave, 500000 unidades de cuota = $1.
- Precios: la mayoría de los modelos cobran por separado los tokens de entrada y de salida. Algunos modelos, etiquetados como Pago por solicitud, cobran por llamada. API de LLM → Modelos y precios muestra los precios de entrada y salida de cada modelo por 1K tokens y sus coeficientes. Un grupo también puede aplicar un multiplicador de precio, que se muestra en las opciones del grupo al crear una clave.
Cada solicitud debe ajustarse tanto a la cuota de su cuenta como al límite de cuota de la propia clave. Si cualquiera de las dos se agota, la solicitud falla.
Administrar claves de API
Abra API de LLM → Tokens de API (/llm/tokens). La lista muestra estas columnas para cada clave:
| Columna | Descripción |
|---|---|
| Nombre | El nombre que introdujo al crear la clave |
| Estado | Activado / Desactivado / Caducado / Agotado |
| Cuota restante/total | Una barra de progreso de la cuota restante. Las claves con cuota ilimitada muestran Crédito ilimitado. |
| Grupo | El grupo de la clave. Disyuntor inteligente indica el grupo automático. |
| Clave | Parcialmente oculta de forma predeterminada. Haga clic en el icono del ojo para mostrarla o en el icono de copiar para copiarla. |
| Modelos disponibles | Muestra Sin límite cuando no se establecen límites de modelos |
| Restricciones de IP | Muestra Sin límite cuando no se establece ninguno |
| Creada / Vence | Nunca |
En la columna Acciones, utilice el interruptor para habilitar o deshabilitar una clave, el icono de edición para cambiar su configuración o el icono de eliminación para eliminarla. Las solicitudes que utilizan una clave eliminada fallan de inmediato.
Opciones de las claves
| Campo | Descripción |
|---|---|
| Nombre | Obligatorio. Asigne nombres a las claves según su propósito, por ejemplo "prod-support-bot". |
| Grupo | Déjelo vacío para utilizar el grupo predeterminado. La lista solo muestra los grupos que su cuenta puede utilizar y puede incluir una descripción y un multiplicador de precio para cada uno. Elija Disyuntor inteligente para que la plataforma seleccione un grupo disponible. El grupo determina a qué modelos puede llamar la clave y el multiplicador de precio. |
| Cuota ilimitada | Cuando está habilitada, la clave no tiene un límite propio y solo está limitada por la cuota de su cuenta. |
| Límite de cuota | Se muestra cuando la cuota ilimitada está deshabilitada. Introduzca la cuota máxima que puede consumir esta clave (500000 = $1). Cuando se agota, el estado de la clave cambia a Agotada. |
| Activar restricciones de modelos / Modelos disponibles | Cuando está habilitado, indique los nombres de los modelos a los que puede llamar la clave, separados por comas, por ejemplo gpt-4o-mini,text-embedding-3-small. Las solicitudes a otros modelos se rechazan. |
| Restricciones de IP | Una IP de origen permitida por línea. Déjelo vacío para no establecer ningún límite. Utilice esta opción cuando las llamadas provengan únicamente de servidores fijos. |
| Fecha de vencimiento | Déjelo vacío para que la clave nunca venza. No puede elegir una fecha pasada. Cuando llega la fecha, el estado de la clave cambia a Vencida. |
Si edita una clave deshabilitada o vencida y le asigna un vencimiento válido (o ninguno), se vuelve a habilitar automáticamente al guardar.
Recomendaciones de seguridad
- Cree claves independientes para cada aplicación y entorno, de modo que pueda deshabilitarlas y auditarlas individualmente.
- Asigne un límite de cuota a las claves utilizadas por aplicaciones de acceso público. Si se filtra la clave, la pérdida quedará limitada.
- Establezca un límite de IP para las llamadas desde el servidor siempre que pueda.
- Guarde las claves únicamente en el servidor, nunca en el código del navegador ni de aplicaciones móviles. Si sospecha que se ha filtrado una clave, deshabilítela o elimínela de inmediato y cree una nueva.
Añadir cuota
- Transferencia: en Descripción general de la cuenta, haga clic en Transferir en la tarjeta Saldo actual para mover fondos desde su saldo principal. El mínimo es 1 y el cuadro de diálogo muestra cuánta cuota recibirá. Las transferencias no se pueden revertir.
- Código de canje: introduzca el código en la tarjeta Recargar con código de canje de Descripción general de la cuenta y haga clic en Canjear.
- Recargar su saldo principal: haga clic en Recargar saldo en la tarjeta Saldo actual para ir a Facturación → Saldo.
Registros de uso
API de LLM → Registro de solicitudes (/llm/logs) muestra todas las llamadas y todos los cambios de su cuota.
- Filtros: intervalo de tiempo, nombre de la clave (token), nombre del modelo y tipo. Los tipos son Recargar saldo, Gasto, Gestionar, Sistema y Error.
- Columnas: fecha y hora, clave, tipo, modelo, duración y tiempo hasta el primer token, tokens de entrada, tokens de salida, costo, IP de origen y detalles. Si el modelo solicitado se asignó a otro modelo, la entrada muestra tanto el modelo solicitado como el modelo real.
- Resumen: la parte superior de la página muestra los totales del filtro actual, como el total de registros, las solicitudes exitosas y las solicitudes fallidas.
Para solucionar problemas, filtre primero por el tipo Error y luego lea el mensaje de error en los detalles.
Estadísticas de uso
API de LLM → Uso (/llm/stats) resume el uso en un intervalo de tiempo:
- Cuota total, utilizada y restante, y porcentaje de uso
- Solicitudes, tokens y gasto en el período seleccionado
- Un gráfico de tendencia de uso, gasto por modelo y una clasificación de modelos por cantidad de solicitudes
- Una tabla de desglose diario con fecha, modelo, solicitudes, tokens y cuota consumida
La página Descripción general de la cuenta también muestra un resumen breve: cantidad de solicitudes, cuota y tokens del período, y promedios de RPM (solicitudes por minuto) y TPM (tokens por minuto) en el intervalo de fechas seleccionado.