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-token

Los 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

EndpointMétodoUso
/v1/management/balanceGETObtener el saldo del Workspace
/v1/management/api-keysGETListar API keys
/v1/management/api-keysPOSTCrear una API key
/v1/management/api-keys/{keyId}PATCHCambiar su nombre, límite, modelos, expiración o estado
/v1/management/api-keys/{keyId}/usageGETObtener registros individuales de uso
/v1/management/api-keys/{keyId}/billingGETObtener 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: null significa ilimitado. 0 evita que la key incurra en gastos.
  • Los importes utilizan USD. Enviar CNY devuelve 400 currency_retired.
  • inactive se puede volver a habilitar. Usa revoked para 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.

EstadocodeSignificado
400validation_errorUn campo o parámetro de consulta no es válido
400invalid_model_accessUn modelo en models no está permitido por la política de modelos del Workspace
400currency_retiredlimitCurrency es CNY; utiliza USD
401invalid_management_tokenEl token falta, está mal formado o ha sido revocado
403organization_inactiveEl Workspace no está activo
404not_foundLa API key no se encuentra en este Workspace
409api_key_revokedUna key revocada no se puede volver a habilitar; crea una nueva key
429report_busyHay 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"

Siguiente

En esta página