Gerenciamento
API de Gerenciamento
Verifique saldos do Workspace, gerencie chaves de API e consulte uso e faturamento
Use a Management API a partir do seu próprio backend ou automação para gerenciar um Workspace do TokenLab. Ela usa um token de gerenciamento, portanto o programa não precisa de uma chave de API comum.
Crie um token de gerenciamento em Dashboard → API → Management Tokens:
Authorization: Bearer mt-your-management-tokenTokens de gerenciamento e chaves de API têm funções diferentes. Use mt-... apenas com /v1/management/*. Use sk-... com APIs de modelos, como /v1/responses.
Endpoints
| Endpoint | Método | Uso |
|---|---|---|
/v1/management/balance | GET | Obter o saldo do Workspace |
/v1/management/api-keys | GET | Listar chaves de API |
/v1/management/api-keys | POST | Criar uma chave de API |
/v1/management/api-keys/{keyId} | PATCH | Alterar seu nome, limite, modelos, expiração ou status |
/v1/management/api-keys/{keyId}/usage | GET | Obter registros individuais de uso |
/v1/management/api-keys/{keyId}/billing | GET | Obter um resumo de faturamento |
Chaves de API
- O segredo completo de uma nova chave aparece apenas na resposta de criação.
models: []não adiciona nenhuma restrição de modelo no nível da chave.limitAmount: nullsignifica ilimitado.0impede que a chave gere gastos.- Os valores usam USD. Enviar
CNYretorna400 currency_retired. inactivepode ser ativado novamente. Userevokedpara desativar uma chave permanentemente.
Uso e Faturamento
/usage retorna registros paginados e suporta filtros por modelo, fabricante do modelo, cenário e data. Registros liquidados podem incluir billing_transaction_id; salve-o com request_id quando precisar correlacionar uma cobrança a uma requisição.
/billing retorna totais agrupados por modelo, fabricante do modelo, cenário e data. Não inclui recargas do Workspace ou faturas.
Um endDate contendo apenas data, como 2026-07-31, significa 00:00 UTC no início desse dia. Para incluir o dia inteiro, passe a data seguinte ou um horário no formato RFC3339, como 2026-07-31T23:59:59Z.
Erros
Os erros usam o objeto error padrão. Trate-os por status e code.
| Status | code | Significado |
|---|---|---|
| 400 | validation_error | Um campo ou parâmetro de consulta é inválido |
| 400 | invalid_model_access | Um modelo em models não é permitido pela política de modelos do Workspace |
| 400 | currency_retired | limitCurrency é CNY; use USD |
| 401 | invalid_management_token | O token está ausente, malformado ou foi revogado |
| 403 | organization_inactive | O Workspace não está ativo |
| 404 | not_found | A chave de API não está neste Workspace |
| 409 | api_key_revoked | Uma chave revogada não pode ser reativada; crie uma nova chave |
| 429 | report_busy | Muitos relatórios de uso ou faturamento estão em execução. Tente novamente após os segundos indicados em Retry-After |
Exemplo
curl "https://api.tokenlab.sh/v1/management/balance" \
-H "Authorization: Bearer mt-your-management-token"