Saltar al contenido
Documentación 1ZheAI
Español

Obtener y gestionar claves API

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.

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

Sección titulada “Crear una clave API”

  1. Iniciar sesión en la consola

    Abre 1zheai.com/console.

  2. Nuevo

    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 formularioValor predeterminadoDescripción
    NombreVacíoDistingue las claves API en el registro de llamadas por este nombre
    Fecha de caducidadNunca caducaOpcional: 1 hora, 1 día, 1 mes, o especificar una fecha y hora concretas
    Cantidad1Crea varias a la vez; al nombre se le añade automáticamente un sufijo aleatorio
    Interruptor «Cuota ilimitada»ActivadoAl 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 disponiblesSi 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ónSolo permite las llamadas desde las IP o rangos CIDR listados

  3. Copiar y guardar

    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

Sección titulada “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

Sección titulada “Dónde guardarla”
Shell 配置（macOS / Linux）
# 写进 ~/.zshrc 或 ~/.bashrc，只在本机生效
export 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

Sección titulada “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

Sección titulada “Preguntas frecuentes”
¿Se puede usar la misma clave API con Claude Code y Cursor a la vez?

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.

¿El mensaje Invalid token / 401 es un problema de la clave API?

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.

¿Las claves API caducan?

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.