Seguridad de claves de API de IA y control de costos
Protege tus cargas de IA con claves separadas, créditos, vencimiento, límites de modelos, listas de IP permitidas, enrutamiento, rotación y atribución de costos auditable.

Una clave de API de IA debe identificar el límite de una sola carga de trabajo, no a toda una organización para siempre. Las claves separadas facilitan el control del acceso, los créditos, el enrutamiento, la rotación y los registros de uso, sin exponer una misma credencial en aplicaciones no relacionadas.
Las claves de API de Modelflare pueden combinar una fecha de vencimiento, créditos limitados o ilimitados, límites de modelos, una lista de IP permitidas y una política de enrutamiento. Estos controles funcionan mejor cuando se diseñan juntos, y no solo cuando se agregan después de un incidente.
Empieza con una clave por carga de trabajo
Crea claves separadas para los límites que necesiten un acceso o una contabilidad independientes, por ejemplo:
- la API de producción y los procesos en segundo plano;
- desarrollo y CI;
- un agente de programación o una herramienta local;
- una aplicación orientada a clientes;
- un colaborador temporal o una migración;
- una carga de trabajo por lotes de alto costo.
Usa nombres que describan el entorno y el propósito, como prod-support-agent o dev-evaluation. Un nombre claro hace que los registros de solicitudes y las decisiones de rotación se entiendan sin revelar el secreto.
Mantén el secreto fuera del código visible para el cliente
Guarda la clave completa en un administrador de secretos del lado del servidor o en una variable de entorno protegida. No la incluyas en:
- JavaScript del navegador ni paquetes de apps móviles que los usuarios puedan inspeccionar;
- el control de versiones, imágenes de contenedores, capturas de pantalla ni tickets;
- eventos de analítica, herramientas de seguimiento de errores, el historial de la terminal ni los registros de la aplicación;
- URL, cadenas de consulta ni ejemplos de comandos copiados con valores reales.
En una aplicación de navegador, envía las solicitudes a través de un backend que autentique al usuario y guarde la clave de Modelflare. Si una clave pudo haberse filtrado, crea una de reemplazo, mueve la carga de trabajo, verifica el tráfico con la nueva clave y revoca la anterior.
Usa los créditos y el vencimiento como límites independientes
Un límite de créditos en la clave establece un tope de uso estricto para esa clave. Una fecha de vencimiento limita durante cuánto tiempo la credencial sigue siendo válida. Cada control resuelve un riesgo distinto:
| Control | Propósito principal |
|---|---|
| Créditos limitados | Limita la cantidad de uso atribuible a la clave |
| Créditos ilimitados | Evita un tope a nivel de clave; los créditos de la cuenta y las demás políticas siguen aplicándose |
| Vencimiento | Termina el acceso después de un tiempo definido |
| Deshabilitar o revocar | Detiene de inmediato cualquier acceso nuevo |
Las claves de desarrollo, de colaboradores y de evaluación normalmente deben tener créditos limitados y una fecha de vencimiento. Las claves de producción pueden necesitar un límite de créditos más alto o ilimitado, pero igual se benefician de una atribución separada por carga de trabajo y de un plan de rotación.
Los créditos no reemplazan los límites de concurrencia ni el control de reintentos del cliente. Una ráfaga puede consumir rápidamente el monto restante, y las fallas repetidas pueden generar solicitudes adicionales.
Restringe los modelos cuando la carga de trabajo es acotada
Los límites de modelos impiden que una clave solicite modelos fuera de su conjunto previsto. Esto reduce el uso accidental de un modelo incompatible o inesperadamente caro y ofrece un límite 403 más claro cuando el cliente pide algo a lo que no debería acceder.
Mantén el conjunto permitido alineado con el endpoint. Que una clave pueda listar un modelo no basta: también se necesita un cliente y un protocolo que admitan el formato de solicitud de ese modelo. Revisa el contrato vigente en Modelos y precios en lugar de copiar los ID de modelo en un documento de políticas de larga duración.
Agrega reglas de IP solo cuando la ruta de red sea estable
Una lista de IP permitidas compara la IP del cliente que observa Modelflare con las direcciones individuales o los rangos CIDR configurados en la clave. Es útil para servidores con una salida de red conocida, pero puede interrumpir el tráfico cuando:
- una carga de trabajo en la nube cambia sus direcciones NAT de salida;
- las solicitudes pasan por un proxy o gateway nuevo;
- las rutas de IPv4 e IPv6 son distintas;
- una persona desarrolladora cambia de red;
- el CIDR configurado es más amplio o más estrecho de lo previsto.
Verifica la ruta de salida real antes de activar la restricción, mantén una vía de rotación de emergencia y no consideres la lista de IP permitidas como un reemplazo de la protección del secreto.
Elige entre el enrutamiento normal y el inteligente de forma intencional
| Tipo de clave | Comportamiento de enrutamiento | Mejor uso |
|---|---|---|
| Clave de API normal | Un grupo principal explícito más grupos de respaldo ordenados opcionales | Cargas de trabajo que requieren un orden de rutas y una política de grupos conocidos |
| Clave de API inteligente (Smart API Key) | Evalúa los grupos aptos de la cuenta con una estrategia equilibrada, de prioridad a la estabilidad o de prioridad al precio más bajo | Cargas de trabajo que buscan una selección automática de rutas más amplia |
Ambos tipos de clave siguen enviando el modelo y el protocolo solicitados. La política de enrutamiento elige un grupo apto; no garantiza que todos los grupos admitan todos los modelos o funciones. Una lista de respaldo normal debe probarse en orden. Una clave de API inteligente debe evaluarse con los requisitos reales de latencia, precio y compatibilidad antes de pasar a producción.
Para conocer el comportamiento en detalle, lee enrutamiento confiable de API de IA.
Rota la clave sin interrupciones evitables
Usa una rotación con superposición:
- Crea una clave nueva con las mismas restricciones previstas.
- Guárdala en el sistema de secretos de la aplicación.
- Despliega la nueva credencial sin eliminar la anterior.
- Verifica el acceso a los modelos y una solicitud real.
- Confirma que aparecen registros de uso nuevos con la nueva clave.
- Quita la clave anterior de todos los despliegues y tareas de automatización.
- Deshabilita o elimina la clave anterior.
- Supervisa si llegan solicitudes inesperadas con la credencial retirada.
Si hay un compromiso activo, revoca primero y acepta la interrupción controlada. El procedimiento con superposición es para rotaciones planificadas, no para mantener una exposición.
Vincula la política de claves con la revisión de costos
El aislamiento por clave permite actuar a partir de la revisión de costos. Filtra los registros de uso por clave y luego compara el modelo, el grupo, el uso de entrada y salida, el estado, los reintentos y el costo. Un límite de créditos puede impedir el uso posterior, pero los registros de solicitudes explican qué lo consumió.
Consulta control de costos de API de IA para seguir un proceso de revisión repetible.
Lista de verificación de claves de API
- Una clave por aplicación, entorno o carga de trabajo con responsable.
- Ningún secreto en código del navegador, repositorios, registros, URL ni capturas de pantalla.
- Créditos limitados y fecha de vencimiento para usos temporales o experimentales.
- Restricciones de modelos para cargas de trabajo acotadas.
- Reglas de IP solo para una ruta de salida verificada y estable.
- Un orden de respaldo normal explícito o una estrategia inteligente elegida de forma intencional.
- Rotación probada antes de quitar la clave anterior.
- Uso y costo revisados por clave después de cada cambio de política.
Preguntas frecuentes
¿Una clave con créditos ilimitados elimina todos los límites de gasto?
No. Elimina el tope de créditos a nivel de clave. Los créditos de la cuenta, los precios de los modelos, la política de grupos, los límites de solicitudes y los demás controles del servicio siguen aplicándose.
¿Varias claves permiten evitar un límite de frecuencia?
No necesariamente. Un límite puede aplicarse a nivel de cuenta, de grupo de modelos o de ruta. Crea claves para separar el acceso y la atribución, no como una forma no verificada de evitar los límites de frecuencia.
¿Basta una lista de IP permitidas si se filtra una clave?
No. Las reglas de red reducen desde dónde se puede usar una clave, pero las rutas de red cambian y la configuración puede ser incorrecta. Rota las credenciales expuestas y mantén el secreto protegido tanto en reposo como en el despliegue.