Crear una clave de API
Crea claves en la consola con límite de gasto y caducidad opcionales; la clave completa solo se muestra una vez.
Necesitas una clave de API antes de llamar a la API. Las claves se crean y se gestionan en la página «Claves de API» de la consola; una cuenta puede tener varias claves para distintos fines.
Cómo crear una clave
- Inicia sesión y abre la consola, y elige Claves de API en la navegación izquierda.
- Haz clic en «Crear clave» y rellena lo siguiente:
| Campo | Obligatorio | Descripción |
|---|---|---|
| Nombre | Sí | Ponle un nombre según su finalidad para distinguirla fácilmente, por ejemplo production, test. |
| Límite de gasto (USD) | Opcional | Tope de gasto acumulado de esta clave. Déjalo vacío para que sea ilimitado. |
| Fecha de caducidad | Opcional | La clave deja de funcionar automáticamente después de esa fecha. Déjala vacía para que no caduque. |
- Envía el formulario para crearla. El diálogo muestra la clave completa una única vez: cópiala y guárdala en un lugar seguro de inmediato.
Cómo se muestran las claves
- La clave completa se muestra solo una vez, en el momento de crearla. Después de cerrar el diálogo ya no se puede volver a ver.
- La lista de claves muestra siempre una forma enmascarada (prefijo y últimos 4 caracteres) para protegerte de miradas ajenas.
- ¿Has perdido una clave? Elimínala y crea otra nueva: la nueva clave funciona de inmediato.
Recomendaciones de seguridad
- No pongas nunca una clave en código de frontend, en un repositorio público ni en un mensaje de chat: cualquiera que tenga la clave puede gastar tu saldo.
- Separa las claves por entorno (una para producción, otra para pruebas) y define un límite de gasto en la clave de producción para acotar el daño potencial.
- Si sospechas de una filtración, elimina la clave y crea otra nueva de inmediato. La eliminación surte efecto al momento: las llamadas con la clave antigua reciben 401.
- Para dar acceso temporal a alguien, crea una clave aparte con un límite pequeño y elimínala después, en lugar de compartir tu clave principal.

