API del panel
MarkdownMé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-…)
| Aspecto | URL | Autenticación |
|---|---|---|
| API del panel | https://ailoot.ai/api/v1 | Authorization: Bearer $TOKEN : token del panel obtenido después de iniciar sesión |
| API de modelos | https://api.ailoot.ai/v1 | Clave 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.
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.
{
"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.
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.