Ir al contenido principal
Español— Elegir un idioma
Menú

Genera y asegura tu clave de API

Lección 2 de 14 Actualizado el 29 de julio de 2026 Desarrollador
En esta página
  1. La credencial que autentica tus solicitudes
  2. Genera tu primera clave
  3. Almacénala sin codificarla nunca directamente
  4. Rota tus claves
  5. Reduce la superficie de exposición
  6. Puntos clave

La credencial que autentica tus solicitudes

Tu clave de API autentica cada solicitud enviada a los modelos de Mistral: sin ella, no se acepta ninguna llamada. Piensa en ella como una contraseña técnica, salvo que viaja a través de código, archivos de configuración y tuberías de despliegue, lo que significa que termina en muchos más lugares que una contraseña estándar. Cualquiera que la tenga puede consumir tu cuota y generar costes en tu cuenta.

Genera tu primera clave

En la Consola de Mistral, abre tu espacio de trabajo y navega hasta la sección API Keys en la barra lateral. Haz clic en Create new key y asígnale un nombre descriptivo, como dev-chatbot-mars-2026. Este nombre no tiene función técnica alguna, pero te salvará el día cuando coexistan seis claves en la lista y necesites revocar solo una: «key 3» no te dice nada, mientras que dev-chatbot-mars-2026 lo dice todo.

La clave se muestra una única vez, en el momento de la creación. Cópiala inmediatamente y guárdala en un lugar seguro. Si cierras la ventana antes de copiarla, no hay forma de recuperarla: deberás generar una nueva. Una clave de Mistral consta de un prefijo seguido de una larga cadena alfanumérica. No la confundas con tu ID de espacio de trabajo ni con un token JWT: a diferencia de este último, no caduca por sí sola y permanece válida hasta que la revoques.

Almacénala sin codificarla nunca directamente

La regla de oro es simple: nunca codifiques tu clave de API directamente en el código fuente. El día que ese archivo aterrice en un repositorio compartido, la clave irá con él. Usa siempre una variable de entorno en su lugar.

En Linux y macOS, declárala en el terminal:

export MISTRAL_API_KEY="your-api-key-here"

Esta variable desaparece cuando cierras el terminal; para hacerla persistente, añade la línea a tu archivo ~/.bashrc, ~/.zshrc o ~/.profile.

En Windows, el equivalente en PowerShell es el siguiente:

$env:MISTRAL_API_KEY = "your-api-key-here"

Y para que sobreviva a un reinicio de sesión:

[System.Environment]::SetEnvironmentVariable("MISTRAL_API_KEY", "your-api-key-here", "User")

En un proyecto de aplicación, la práctica más común es crear un archivo .env en la raíz:

MISTRAL_API_KEY=your-api-key-here

Añade .env a tu .gitignore inmediatamente, antes de tu primer commit, no después. En Python, la biblioteca python-dotenv lee este archivo e inyecta las variables al inicio, ofreciéndote la comodidad de un archivo local sin el riesgo de versionar secretos.

Rota tus claves

Sustituye una clave por tres motivos. Inmediatamente, si ha sido expuesta de cualquier forma: un commit enviado a un repositorio Git público, un mensaje precipitado en Slack o rastros en los registros del servidor. Regularmente en producción, siendo noventa días una cadencia razonable. Y cuando un colaborador se marche y tuviera acceso, el mismo día en que devuelva su credencial.

El procedimiento evita interrupciones del servicio si respetas el orden:

  1. Genera una nueva clave en la Consola
  2. Actualiza la variable de entorno en todos tus despliegues
  3. Verifica que todo funciona con la nueva clave
  4. Revoca la clave antigua solo después de esta verificación

Intercambiar los pasos 3 y 4 es el error clásico: revocas primero «por seguridad», solo para descubrir que un servicio olvidado seguía usando la clave antigua. Esta rotación sin tiempo de inactividad garantiza que ningún componente falle durante la transición.

Reduce la superficie de exposición

Si varias aplicaciones llaman a la API, crea una clave por aplicación. Si una se ve comprometida, solo necesitas revocar esa clave específica sin detener las demás. Bajo el mismo principio, nunca reutilices una clave de producción en desarrollo: ese es precisamente el entorno donde los secretos circulan con mayor libertad.

A continuación, supervisa el uso desde la Consola, que expone registros de uso para cada clave. Un pico repentino en tokens o llamadas desde una dirección IP desconocida debe desencadenar una rotación inmediata, sin esperar a la confirmación del incidente.

Tres errores finales merecen mención porque los encontramos cada semana. Una clave publicada en un repositorio Git público permanece legible en el historial incluso después de borrar el archivo: la única respuesta válida es la revocación. Una clave enviada en texto claro por correo electrónico o mensajería instantánea queda archivada para siempre en servidores que no controlas. Y una clave caducada o revocada que permanece en un despliegue produce errores 401 Unauthorized que a menudo tardan una hora en diagnosticarse simplemente porque a nadie se le ocurrió comprobarlo.

Puntos clave

  • Genera tus claves desde la sección API Keys de tu espacio de trabajo en la Consola de Mistral
  • Almacénalas exclusivamente en variables de entorno o en un gestor de secretos
  • Realiza una rotación regular y una rotación inmediata en caso de exposición
  • Crea una clave por aplicación para limitar el impacto de un compromiso
  • Añade siempre .env a tu .gitignore