Primeros pasosAutenticación

Autenticación

Todos los endpoints, excepto GET /v1/models, requieren una clave de API. Envíala en cualquiera de estos encabezados. Los dos funcionan en todos los endpoints, así que usa el que envíe tu cliente:

  • Authorization: Bearer $YOUR_KEY, que envían los SDK de OpenAI y la mayoría de las herramientas.
  • x-api-key: $YOUR_KEY, que envían los SDK de Anthropic.

Marcadores de posición: $API_BASE es https://api.abliteratedllm.dev/v1, $API_ORIGIN es https://api.abliteratedllm.dev y $YOUR_KEY es tu clave de API.

bash
# OpenAI style
curl $API_BASE/balance -H "Authorization: Bearer $YOUR_KEY"

# Anthropic style
curl $API_BASE/balance -H "x-api-key: $YOUR_KEY"

Claves de API

Crea, renombra, edita y revoca claves en Claves de API, donde también ves cuándo se usó cada clave por última vez (con unos minutos de precisión) y cuánto ha gastado.

  • Una clave es sk- seguido de 48 letras y dígitos.
  • Se muestra una sola vez, al crearla. Solo guardamos un hash con clave de ella, así que no podemos volver a mostrarla. El panel identifica las claves por sus primeros 10 caracteres.
  • Una cuenta puede tener hasta 20 claves activas. Revoca una para dejar lugar a otra.
  • La creación de claves está limitada a 30 intentos por hora por cuenta. Los intentos adicionales reciben 429 rate_limit_exceeded con un encabezado Retry-After.
  • La revocación de una clave se aplica en un plazo de 30 segundos.
  • Una clave puede tener fecha de vencimiento. Deja de funcionar a las 00:00 UTC de esa fecha, y a partir de entonces las solicitudes reciben 401 invalid_api_key con el mensaje This API key expired on 2026-12-31 00:00 UTC. Mientras no la revoques, puedes asignarle a una clave vencida una fecha posterior para volver a usarla.
  • El Playground usa su propia clave, que se administra automáticamente y no aparece en la lista.

Topes de gasto

Cada clave puede tener un tope diario, un tope mensual y un presupuesto total, en cualquier combinación. Los días y los meses son UTC; el presupuesto total cuenta lo que la clave gastó desde que se introdujeron los presupuestos totales (en las claves más antiguas, solo sus últimos 30 días de uso antes de esa fecha). Antes de reenviar una solicitud, su costo máximo posible (la retención descrita en Límites de frecuencia y prueba gratis) se suma a lo que la clave ya gastó en el período. Si ese total supera un tope, la solicitud falla con 402 key_spend_cap_reached y no se cobra nada; el mensaje indica el tope (diario, mensual o total). Los topes son una buena forma de darle a un script o a un compañero de equipo una clave con un presupuesto fijo. GET /v1/balance indica cuánto queda de cada uno.

El número de cuenta y las claves de API son independientes

Tu número de cuenta de 16 dígitos sirve para iniciar sesión en el sitio web. Nunca funciona como clave de API, y una clave de API no permite iniciar sesión en el sitio. Mantén ambos en secreto: quien tenga el número de cuenta controla la cuenta y su crédito.

Errores

El estado de la cuenta se verifica antes que cualquier otra cosa de la solicitud.

EstadoCódigoSignificado
401invalid_api_keyNo se envió ninguna clave, o la clave tiene un formato incorrecto, es desconocida, está revocada o está vencida.
403account_suspendedLa cuenta está suspendida. Se rechazan todas sus claves hasta que termine la suspensión.
403account_bannedLa cuenta está bloqueada de forma permanente. Sus claves se revocan y el crédito restante se pierde.

La lista completa está en la página Errores.

IDs de solicitud

Todas las respuestas, incluidos los errores, llevan un encabezado x-request-id. Inclúyelo cuando contactes a soporte o informes un problema. Nos permite encontrar los metadatos de la solicitud (hora, clave, modelo, cantidad de tokens, costo, estado y latencia), que conservamos durante 30 días. No guardamos prompts ni respuestas (consulta la política de privacidad), así que el ID de solicitud es la única forma de identificar una solicitud concreta.