Gerenciamento
Criar API Key
Crie uma API key para o Workspace atual.
Visão Geral
Crie uma API key no Workspace associado ao management token. O segredo completo aparece apenas uma vez, nesta resposta.
Corpo da Requisição
| Campo | Tipo | Padrão / Limites | Observações |
|---|---|---|---|
name | string | opcional, padrão Default Key, tamanho 1-50 | Nome de exibição, com espaços removidos no servidor |
limitAmount | number | string | null | 0–100000 USD | null significa ilimitado; 0 impede gastos. Strings decimais suportam até 6 casas decimais. Omitir este campo ao criar uma chave significa ilimitado. |
limitCurrency | enum | padrão USD | Apenas USD. Enviar CNY retorna 400 currency_retired. |
models | string[] | padrão [] | Allowlist de modelos opcional |
deliveryPolicy | string | null | auto, verified, official, null | null herda a política de entrega do Workspace. |
expiresAt | string | null | data e hora RFC3339 | null significa sem expiração |
Observações
-
Campos monetários são apenas em USD. Entradas em
CNYforam descontinuadas e retornam400 currency_retired. -
models: []não adiciona restrição de modelos no nível da chave. -
limitAmount: 0cria uma chave válida, mas que não pode gastar cota até ser atualizada.
Requisição
curl -X POST "https://api.tokenlab.sh/v1/management/api-keys" \
-H "Authorization: Bearer mt-your-management-token" \
-H "Content-Type: application/json" \
-d '{
"name": "Backend Worker",
"limitAmount": 500,
"models": ["veo3.1", "kling-v3.0"],
"expiresAt": "2026-12-31T23:59:59Z"
}'Requisição / Resposta
Esta página fornece o schema OpenAPI e exemplos de requisição copiáveis. Envie requisições de gerenciamento a partir do seu terminal ou cliente com um Management Token; o envio direto não está disponível nesta página.
Resposta
{
"id": "key_abc123def456",
"name": "Backend Worker",
"key": "sk-live-redacted",
"key_prefix": "sk-live...",
"status": "active",
"limit_amount": 500,
"limit_amount_decimal": "500",
"used_amount": 0,
"used_amount_decimal": "0",
"models": [
"veo3.1",
"kling-v3.0"
],
"expires_at": "2026-12-31T23:59:59.000Z",
"last_used_at": null,
"created_at": "2026-07-08T03:00:00.000Z",
"delivery_policy": null
}Campos importantes
active, inactive, suspended ou revoked.null significa ilimitado.null significa ilimitado.auto, verified, official, null. null herda a política de entrega do Workspace.null para sem expiração.null quando não utilizada.Autorização
ManagementTokenAuth Autenticação por token de gerenciamento. Crie ou gerencie Tokens de Gerenciamento em Dashboard > API > Management Tokens.
Local: header
Corpo da requisição
application/json
Resposta
application/json
application/json
application/json
application/json