---
title: "Obtener y gestionar claves API"
description: "Cómo crear claves API que empiezan con sk- en la consola de 1zheai, y cómo almacenarlas, rotarlas y mitigar daños en caso de filtración."
headingIds: {"Crear una clave API":"section-1","Una clave API por herramienta":"section-2","Dónde guardarla":"section-3","Qué hacer si se filtra":"section-4","Preguntas frecuentes":"section-5"}
---
Una clave API (API key) corresponde a un permiso de llamada, y se descuenta del saldo de tu cuenta. Esta página explica cómo crearla, dónde guardarla y qué hacer si hay un incidente.
## Crear una clave API
Abre [1zheai.com/console](https://1zheai.com/console?lng=es).
En el menú lateral, haz clic en «Claves API» y luego en «Crear clave API» en la esquina superior derecha. Escribe un nombre que indique su propósito, por ejemplo `claude-code-macbook`, `ci-staging`; el resto de los campos puede quedarse sin cambios y funcionará igual. Haz clic en «Guardar cambios».
Campos configurables del formulario:
| Campo del formulario | Valor predeterminado | Descripción |
|---|---|---|
| Nombre | Vacío | Distingue las claves API en el registro de llamadas por este nombre |
| Fecha de caducidad | Nunca caduca | Opcional: 1 hora, 1 día, 1 mes, o especificar una fecha y hora concretas |
| Cantidad | 1 | Crea varias a la vez; al nombre se le añade automáticamente un sufijo aleatorio |
| Interruptor «Cuota ilimitada» | Activado | Al desactivarlo aparece «Límite (USD)»; esta clave API no podrá gastar más de esa cantidad en dólares |
| Restricción de modelos (en «Configuración avanzada») | Vacío, lo que significa que todos los modelos están disponibles | Si se eligen modelos, esta clave API solo podrá invocar esos modelos |
| Lista blanca de IP (en «Configuración avanzada») | Vacío, lo que significa sin restricción | Solo permite las llamadas desde las IP o rangos CIDR listados |
Las claves API empiezan por `sk-`. Después de copiarla, guárdala en un gestor de contraseñas o en una variable de entorno; no la pegues en chats, capturas de pantalla ni repositorios de código.
## Una clave API por herramienta
Se recomienda crear una clave API distinta para cada herramienta y cada máquina. Hay tres ventajas:
- El registro de llamadas se distingue por clave API, de modo que se ve de un vistazo cuánto gastó cada herramienta.
- Si se filtra una clave API, solo hay que eliminar esa; el resto de herramientas no se ven afectadas.
- Cada persona del equipo es responsable de su propia clave API; al irse o cambiar de máquina, se elimina la clave API correspondiente.
## Dónde guardarla
```bash title="Shell 配置（macOS / Linux）"
# 写进 ~/.zshrc 或 ~/.bashrc，只在本机生效
export ONEZHE_API_KEY="sk-你的Key"
```
```powershell title="Windows（当前用户，持久）"
[Environment]::SetEnvironmentVariable("ONEZHE_API_KEY", "sk-你的Key", "User")
# 重新打开终端后生效
```
```bash title=".env（项目本地）"
# .env 要写进 .gitignore
ONEZHE_API_KEY=sk-你的Key
```
El `.claude/settings.json` a nivel de proyecto de Claude Code suele subirse al repositorio, y la documentación oficial de Claude Code recomienda explícitamente no escribir credenciales ahí. Coloca la clave API en el `~/.claude/settings.json` a nivel de usuario, o en un `.claude/settings.local.json` del proyecto que no se suba al repositorio.
## Qué hacer si se filtra
1. Encuéntrala en la lista de «Claves API», haz clic en el icono «Deshabilitar» de la columna «Acciones», o elige «Eliminar» en el menú «⋯». Al deshabilitarla deja de funcionar de inmediato; cualquier llamada posterior con ella devuelve 401 `Invalid token`.
2. Crea una clave API nueva y reemplázala donde se esté usando.
3. Abre el registro de llamadas (menú de la consola «Registro de llamadas»), haz clic en «Expandir», filtra escribiendo el nombre de esta clave API en «Nombre del token» y comprueba si entre las llamadas recientes hay alguna que no hayas iniciado tú.
## Preguntas frecuentes
Sí, una clave API no está vinculada a una herramienta. Solo que, si se mezclan, en el registro no se distingue quién gastó, por lo que se recomienda crearlas por separado.
En la mayoría de los casos, sí. Causas habituales: al copiarla se incluyeron espacios o saltos de línea, la clave API ya fue eliminada, o se introdujo en un campo incorrecto de la herramienta. Para revisarlo paso a paso, consulta[ códigos de error y solución de problemas](/es/docs/troubleshooting/).
Por defecto, nunca caduca. Al crearla o editarla puedes fijar una fecha en «Fecha de caducidad»; una vez caducada, cualquier llamada devuelve 401 `Invalid token`, igual que la respuesta cuando la clave API está mal escrita. La columna «Caducidad» de la lista muestra la fecha de caducidad de cada clave API.