# Claves de API

Crea una clave para que tu propio agente de IA o tu script puedan usar SimianX AI, cópiala una vez, limita lo que puede gastar y revócala.

- Todos los planes. El número de claves depende de tu plan.
- Crear una clave es gratis. Todo lo que ejecuta una clave consume los puntos de tu cuenta.

Una clave de API permite que un agente de IA o un script use SimianX AI para tu cuenta sin tu contraseña. Esta página trata de las claves en sí.

## Crear una clave

1. Abre el menú de la cuenta, selecciona **Mi cuenta** y abre la pestaña **Claves de API**.
2. Selecciona **Crear clave**. Se abre el formulario **Nueva clave de API**.
3. En el campo **Nombre**, escribe un texto que te indique dónde se usa la clave.
4. En **Qué puede hacer esta clave**, elige qué puede hacer la clave: leer datos de mercado y noticias, ejecutar análisis, gestionar pilotos automáticos, gestionar claves. Las tres primeras opciones están seleccionadas de forma predeterminada. Sin el permiso para ejecutar análisis, una clave puede leer datos pero no puede iniciar un análisis.
5. Opcional: define **Presupuesto diario (puntos)**, **Presupuesto mensual (puntos)** o **Llamada única máxima (puntos)**. Un campo vacío significa sin límite.
6. Opcional: rellena **Agente**, **Lista de IPs permitidas** (una dirección por línea) y **Caduca**.
7. Selecciona **Crear clave**.

![El formulario Nueva clave de API con el campo Nombre, las opciones de permisos, tres campos opcionales de presupuesto en puntos, el campo Agente, el cuadro Lista de IPs permitidas, la lista Caduca y el botón Crear clave.](https://fw.simianx.ai/help/es/account-api-key-form.light.ffef0171f4.webp)

*El formulario Nueva clave de API*

## Copiar la clave

La ventana **Tu nueva clave** muestra la clave completa. Selecciona **Copiar** y guarda la clave en tu agente o en un gestor de contraseñas; después selecciona **Listo**.

> **No se puede deshacer**
> La clave completa solo se muestra esta única vez. SimianX AI solo guarda un hash y no puede volver a mostrarla. Si pierdes la clave, revócala y crea una nueva.

![La ventana Tu nueva clave. Tiene cuatro líneas, cada una con un botón Copiar: la clave completa, la línea para definirla como variable de entorno de un agente, una frase que indica al agente que se configure solo y un comando para probar la clave. El botón Listo está abajo.](https://fw.simianx.ai/help/es/account-api-key-token.light.5514bfb7bd.webp)

*La clave se muestra una sola vez*

## Leer la lista

Cada clave muestra su nombre, sus primeros caracteres, los puntos gastados hoy y este mes, su presupuesto y cuándo se usó por última vez.

- **Uso**: solicitudes y puntos de los últimos 7 días, por endpoint.
- **Editar**: cambia el nombre, los permisos, los presupuestos, el agente y la lista de IPs permitidas. Los cambios se aplican a la siguiente solicitud.
- **Revocar**: detiene la clave.

## Revocar una clave

1. Selecciona **Revocar** en la fila de la clave.
2. En el cuadro de diálogo **¿Revocar esta clave?**, selecciona **Revocar**.

> **No se puede deshacer**
> Las solicitudes con una clave revocada dejan de funcionar de inmediato, y la clave no se puede restaurar. Los pilotos automáticos que inició la clave siguen ejecutándose en tu cuenta. Detenlos en la página **Pilotos automáticos** si quieres.

## Puntos

> **Consume puntos**
> Una clave gasta los puntos de tu cuenta, con las mismas tarifas que el sitio web. Define un presupuesto en cada clave para que un agente no pueda gastar más de lo que permites. Consulta [Puntos y tarifas](https://www.simianx.ai/es/points).

## Conviene saber

- La pestaña muestra cuántas claves tienes y cuántas permite tu plan. Al llegar al límite, el botón **Crear clave** se desactiva: revoca una clave o [cambia de plan](https://www.simianx.ai/es/help/points-and-plans/change-plan.md).
- Un agente también puede pedir una clave por sí mismo: te da un enlace, y tú apruebas o rechazas. Consulta [Conectar tu propio agente de IA](https://www.simianx.ai/es/help/market-tools/connect-ai-agent.md).
- Una clave no puede iniciar sesión en el sitio web ni cambiar tu suscripción o tus datos de pago.

---

Página web: https://www.simianx.ai/es/help/account/api-keys
Capítulo: [Cuenta](https://www.simianx.ai/es/help/account.md)
Manual completo: https://www.simianx.ai/es/help/manual.md