Administración
API de gestión
Consulta los saldos del Workspace, gestiona las API keys y obtén información sobre el uso y la facturación
Utiliza la API de gestión desde tu propio backend o automatización para gestionar un Workspace de TokenLab. Utiliza un token de gestión, por lo que el programa no necesita una API key regular.
Crea un token de gestión en Dashboard → API → Tokens de gestión:
Authorization: Bearer mt-your-management-tokenLos tokens de gestión y las API keys tienen roles diferentes. Usa mt-... únicamente con /v1/management/*. Usa sk-... con las API de modelos como /v1/responses.
Endpoints
| Endpoint | Método | Uso |
|---|---|---|
/v1/management/balance | GET | Obtener el saldo del Workspace |
/v1/management/api-keys | GET | Listar API keys |
/v1/management/api-keys | POST | Crear una API key |
/v1/management/api-keys/{keyId} | PATCH | Cambiar su nombre, límite, modelos, expiración o estado |
/v1/management/api-keys/{keyId}/usage | GET | Obtener registros individuales de uso |
/v1/management/api-keys/{keyId}/billing | GET | Obtener un resumen de facturación |
API Keys
- El secreto completo de una nueva key solo aparece en la respuesta de creación.
models: []no añade ninguna restricción de modelos a nivel de key.limitAmount: nullsignifica ilimitado.0evita que la key incurra en gastos.- Los importes utilizan USD. Enviar
CNYdevuelve400 currency_retired. inactivese puede volver a habilitar. Usarevokedpara retirar una key de forma permanente.
Uso y facturación
/usage devuelve registros paginados y admite filtros por modelo, fabricante del modelo, escena y fecha. Los registros liquidados pueden incluir billing_transaction_id; guárdalo junto con request_id cuando necesites asociar un cargo con una solicitud.
/billing devuelve totales agrupados por modelo, fabricante del modelo, escena y fecha. No incluye recargas ni facturas del Workspace.
Un endDate que solo contenga la fecha, como 2026-07-31, representa las 00:00 UTC al inicio de ese día. Para incluir el día completo, pasa la fecha siguiente o una hora RFC3339 como 2026-07-31T23:59:59Z.
Errores
Los errores utilizan el objeto estándar error. Gestiónalos según el estado y el code.
| Estado | code | Significado |
|---|---|---|
| 400 | validation_error | Un campo o parámetro de consulta no es válido |
| 400 | invalid_model_access | Un modelo en models no está permitido por la política de modelos del Workspace |
| 400 | currency_retired | limitCurrency es CNY; utiliza USD |
| 401 | invalid_management_token | El token falta, está mal formado o ha sido revocado |
| 403 | organization_inactive | El Workspace no está activo |
| 404 | not_found | La API key no se encuentra en este Workspace |
| 409 | api_key_revoked | Una key revocada no se puede volver a habilitar; crea una nueva key |
| 429 | report_busy | Hay demasiados informes de uso o facturación en ejecución. Reintenta después de los segundos indicados en Retry-After |
Ejemplo
curl "https://api.tokenlab.sh/v1/management/balance" \
-H "Authorization: Bearer mt-your-management-token"