> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Autenticación

> Aprende a autenticarte con la API de Macaly usando claves API

<Callout icon="user">
  Disponible solo en el [**plan Agencias**](/docs/es/welcome/pricing)
</Callout>

La API de Macaly usa claves API para la autenticación. Las claves API pertenecen a un equipo y comparten el mismo sistema de créditos que la interfaz web.

## Obtener una clave API

1. Inicia sesión en tu cuenta de Macaly
2. Haz clic en tu perfil (arriba a la derecha)
3. Ve a **Ajustes → Claves API**
4. Haz clic en "Crear nueva clave API"
5. Copia la clave inmediatamente (solo se mostrará una vez)

## Usar la clave API

Incluye la clave API en el encabezado `Authorization` en todas las solicitudes:

```
Authorization: Bearer macaly_your_api_key_here
```

### Solicitud de ejemplo

```bash theme={null}
curl -X POST https://www.macaly.com/api/chat \
  -H "Authorization: Bearer macaly_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"content": "Create a landing page"}'
```

## Formato de la clave API

| Propiedad | Valor |
| - | - |
| Prefijo | `macaly_` |
| Longitud total | 39 caracteres |
| Ejemplo | `macaly_abc123def456ghi789jkl012mno345` |

## Buenas prácticas de seguridad

<Warning>
  Las claves API dan acceso completo a los recursos y créditos de tu equipo. Trátalas como contraseñas.
</Warning>

1. **Guarda las claves de forma segura** - Usa variables de entorno, nunca las incluyas en el código
2. **Renueva las claves regularmente** - Revoca y vuelve a crear las claves periódicamente
3. **Usa claves separadas** - Crea claves distintas para diferentes entornos o aplicaciones
4. **Controla el uso** - Comprueba tu saldo regularmente desde el panel
5. **Revoca las claves comprometidas** - Si una clave queda expuesta, revócala de inmediato

## Límites de solicitudes

* Los intentos fallidos con la clave API están limitados a 5 por minuto por dirección IP
* Esto protege frente a ataques de fuerza bruta

## Gestión de claves

Puedes gestionar tus claves API desde el panel de Macaly:

* **Ver claves** - Consulta todas las claves activas con su fecha de creación y último uso
* **Crear claves** - Genera claves nuevas con un nombre opcional para identificarlas
* **Revocar claves** - Desactiva las claves que ya no necesites o que estén comprometidas


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.