docs
API del panel

API del panel

Markdown

Métodos del panel: inicio de sesión, perfil, claves e historial de gastos.

Guía completa

URL y autenticación

  • Panel: https://ailoot.ai (inicio de sesión con credenciales, token del panel)
  • API de modelos: https://api.ailoot.ai (clave sk-…)
AspectoURLAutenticación
API del panelhttps://ailoot.ai/api/v1Authorization: Bearer $TOKEN : token del panel obtenido después de iniciar sesión
API de modeloshttps://api.ailoot.ai/v1Clave sk-… de la sección «Claves de API»; consulta Claves y dirección de la API

Clave sk-… no sustituye al token del panel, y el token del panel no da acceso a la API de modelos. La ruta completa se indica en cada método.

Consultar tu perfil
curl --fail-with-body "https://ailoot.ai/api/v1/user/profile" \
  -H "Authorization: Bearer $TOKEN"

Formato de respuesta y errores

La respuesta contiene code, message y data. Los errores pueden incluir reason y metadata. La paginación en data contiene items, total, page, page_size y pages. El formato de cada método se indica en su descripción.

Estructura de respuesta paginada
{
  "code": 0,
  "message": "success",
  "data": {
    "items": [],
    "total": 0,
    "page": 1,
    "page_size": 20,
    "pages": 1
  }
}

El token del panel se verifica por su vigencia y por si el usuario está activo; si la vinculación de sesión está activada, también se verifican la IP y el navegador. Los códigos TOKEN_EXPIRED, TOKEN_REVOKED, USER_INACTIVE, INVALID_TOKEN y FORBIDDEN distinguen los problemas de sesión y permisos. El límite de frecuencia y la verificación adicional 2FA pueden impedir una solicitud específica.

Cómo leer la referencia

  • Cada entrada contiene el método HTTP, la ruta completa, el acceso, los parámetros, los campos del cuerpo y la respuesta.
  • Obtén los identificadores de una respuesta anterior: KEY_ID, de GET /api/v1/keys; el ID de solicitud, de GET /api/v1/usage.
  • Los campos de los objetos y sus tipos se describen en las páginas «Esquemas de datos».
  • Las plantillas muestran los nombres y tipos de los campos. PLACEHOLDER y TOKEN son marcadores; aquí no hay datos reales.
  • Para recargar saldo, utiliza «Tarifas» en el panel: cómo recargar.

Saldo y frozen_balance

El perfil contiene balance y frozen_balance. frozen_balance es el monto reservado para solicitudes pendientes. Verifica ambos campos junto con el historial.

Claves y límites

GET /api/v1/keys devuelve tus claves. Los campos quota y quota_used indican el límite de gasto de la clave y la parte ya gastada; ip_whitelist, ip_blacklist, status y expires_at controlan el uso de la clave; rate_limit_5h, rate_limit_1d y rate_limit_7d son los límites de gasto por ventanas de tiempo.

Lista y clave propia
curl --fail-with-body "https://ailoot.ai/api/v1/keys" \
  -H "Authorization: Bearer $TOKEN"

# KEY_ID — id de tu propia clave obtenido de la respuesta de la lista
curl --fail-with-body "https://ailoot.ai/api/v1/keys/$KEY_ID" \
  -H "Authorization: Bearer $TOKEN"

Gastos y seguridad

El historial y el dashboard muestran actual_cost, el cargo real, y total_cost, el costo al precio estándar. Los filtros de fecha, modelo, clave y tipo de solicitud se indican en el método. Cambiar la contraseña, TOTP y las claves de acceso (passkeys) requiere las confirmaciones descritas en los métodos correspondientes.

En esta sección: 39 métodos.

¿Tienes alguna pregunta? Envíanos el Request ID y una descripción; te ayudaremos a resolverla.Contactar a soporte