Claves y URL de la API

La clave se crea en el panel de control de ailoot.ai después de registrarte. 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).

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

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

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.

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 el terminal para que se carguen las variables

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

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