Claves y dirección de la API
MarkdownCómo obtener una clave, qué URL configurar en cada SDK y cómo enviar la clave.
Guía completa
Clave de API
La clave se crea en el panel de ailoot.ai después de registrarte. Tiene el formato sk-…. Puedes crear varias claves: una para la computadora 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 vencimiento, listas de IP permitidas y bloqueadas, y límites de gasto para ventanas 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 agotó el límite total), usage_limit_reached (se alcanzó el límite de gasto de la clave para esta ventana de tiempo; espera a que se renueve la ventana o aumenta el límite), api_key_expired o permission_denied (por ejemplo, la solicitud procede de una IP no permitida).
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 |
Cómo enviar la clave
Ailoot admite la clave en cualquiera de estos tres encabezados. El que envíe tu SDK será válido:
| Encabezado | Clientes que usan este encabezado |
|---|---|
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 envió en la URL. Esto evita que la clave se guarde en los registros y en el historial del navegador. Si ya enviaste 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 los encabezados. ?api_key= también se rechaza con un 400 en estas rutas. Aun así, es más confiable enviar la clave en el encabezado x-goog-api-key.
Variables de entorno
Puedes crear una sola variable y utilizarla en la configuración de distintos programas:
# ~/.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"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 la terminal para que se carguen las variablesVerificar la clave
La forma más económica de verificar la clave es solicitar la lista de modelos: es gratis.
curl -s https://api.ailoot.ai/v1/models \
-H "Authorization: Bearer $AILOOT_API_KEY"