Source: https://ailoot.ai/docs/es/keys/
Canonical: https://ailoot.ai/docs/es/keys/
Language: es

[Primeros pasos](https://ailoot.ai/docs/es/) 

# Claves y URL de la API

[Markdown](https://ailoot.ai/docs/es/keys/index.md)

Cómo obtener una clave, qué URL configurar en cada SDK y cómo enviar la clave.

## [](https://ailoot.ai/docs/es/keys/#key)Clave API

La clave se crea en el panel de control de [ailoot.ai](https://ailoot.ai) después de [registrarte](https://ailoot.ai/register). Tiene el formato `sk-…`. Puedes crear varias claves: una para el ordenador de trabajo, otra para el servidor y una para cada aplicación. Así resulta más fácil revocar una sin afectar a las demás.

Puedes establecer un límite total de gasto, una fecha de caducidad, listas de IP permitidas y bloqueadas, y límites de gasto para periodos de 5 horas, 1 día y 7 días. Si se alcanza alguno de los límites o se incumple alguna restricción, recibirás un error con una explicación clara: `api_key_quota_exhausted` (se ha agotado el límite total), `usage_limit_reached` (se ha alcanzado el límite de gasto de la clave para este periodo; espera a que se renueve el periodo o aumenta el límite), `api_key_expired` o `permission_denied` (por ejemplo, la solicitud procede de una IP no permitida).

No publiques la clave en el código, en repositorios ni en capturas de pantalla. Guárdala en una variable de entorno o en un gestor de secretos. Si la clave se ha filtrado, elimínala en el panel de control y crea otra.

## [](https://ailoot.ai/docs/es/keys/#base-url)URL de la API

La regla principal: para clientes compatibles con OpenAI, usa una URL con `/v1`; para Anthropic y Gemini, sin ese sufijo.

| Cliente | URL base | Destino de la solicitud |
| --- | --- | --- |
| SDK de OpenAI y clientes compatibles | `https://api.ailoot.ai/v1` | `/v1/chat/completions`, `/v1/responses`, `/v1/embeddings` |
| Anthropic SDK, Claude Code | `https://api.ailoot.ai` | `/v1/messages` |
| Google GenAI SDK, Gemini CLI | `https://api.ailoot.ai` | `/v1beta/models/{model}:generateContent` |
| El cliente solicita la URL completa | `https://api.ailoot.ai/v1/chat/completions` | la URL indicada |

¿Has recibido un 404 justo después de configurar el cliente? Casi siempre se debe a la URL: sobra o falta `/v1`, hay una doble barra o se ha incluido `/chat/completions` cuando el cliente ya lo añade automáticamente.

## [](https://ailoot.ai/docs/es/keys/#auth)Cómo enviar la clave

Ailoot admite la clave en cualquiera de estas tres cabeceras. La que envíe tu SDK será válida:

| Cabecera | Clientes que usan esta cabecera |
| --- | --- |
| `Authorization: Bearer sk-…` | SDK de OpenAI, la mayoría de los clientes |
| `x-api-key: sk-…` | SDK de Anthropic, Claude Code con ANTHROPIC\_API\_KEY |
| `x-goog-api-key: sk-…` | Google GenAI SDK, Gemini CLI |

En las rutas `/v1/…` no se admite una clave en la URL (`?key=` o `?api_key=`): la solicitud devolverá un 400 con el código `invalid_request` y un mensaje indicando que la clave se ha enviado en la URL. Esto evita que la clave se guarde en los logs y en el historial del navegador. Si ya has enviado la clave en una URL, es mejor crear otra.

En las rutas de Gemini `/v1beta/…` se acepta, por compatibilidad con Google, `?key=` con la prioridad más baja, después de las cabeceras. `?api_key=` también se rechaza con un 400 en estas rutas. Aun así, es más fiable enviar la clave en la cabecera `x-goog-api-key`.

## [](https://ailoot.ai/docs/es/keys/#env)Variables de entorno

Puedes crear una sola variable y utilizarla en la configuración de distintos programas:

```bash
# ~/.zshrc o ~/.bashrc
export AILOOT_API_KEY="sk-..."

# para programas que leen los nombres estándar
export OPENAI_BASE_URL="https://api.ailoot.ai/v1"
export OPENAI_API_KEY="$AILOOT_API_KEY"
export ANTHROPIC_BASE_URL="https://api.ailoot.ai"
export ANTHROPIC_AUTH_TOKEN="$AILOOT_API_KEY"
```

```powershell
setx AILOOT_API_KEY "sk-..."

# para programas que leen los nombres estándar
setx OPENAI_BASE_URL "https://api.ailoot.ai/v1"
setx OPENAI_API_KEY "sk-..."
setx ANTHROPIC_BASE_URL "https://api.ailoot.ai"
setx ANTHROPIC_AUTH_TOKEN "sk-..."
# reinicia el terminal para que se carguen las variables
```

## [](https://ailoot.ai/docs/es/keys/#check)Comprobar la clave

La forma más económica de comprobar la clave es solicitar la lista de modelos: es gratis.

```bash
curl -s https://api.ailoot.ai/v1/models \
  -H "Authorization: Bearer $AILOOT_API_KEY"
```

¿Tienes alguna pregunta? Envíanos el Request ID y una descripción; te ayudaremos a resolverla.[Contactar con soporte](mailto:support@ailoot.ai)

## Ailoot · La empresa y su cartera de proyectos





Ailoot se apoya en la experiencia operativa acumulada, una amplia base de clientes, un servicio estable y el seguimiento continuo de KPI.





La empresa y su cartera de proyectos: millones de clientes; ventas por miles de millones al mes.





Ailoot aplica esa experiencia operativa al acceso por API a funciones de IA en productos de clientes, agentes, aplicaciones y automatizaciones.