Gerenciamento

Criar API Key

Crie uma API key para o Workspace atual.

POSThttps://api.tokenlab.sh/v1/management/api-keys

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

CampoTipoPadrão / LimitesObservações
namestringopcional, padrão Default Key, tamanho 1-50Nome de exibição, com espaços removidos no servidor
limitAmountnumber | string | null0–100000 USDnull significa ilimitado; 0 impede gastos. Strings decimais suportam até 6 casas decimais. Omitir este campo ao criar uma chave significa ilimitado.
limitCurrencyenumpadrão USDApenas USD. Enviar CNY retorna 400 currency_retired.
modelsstring[]padrão []Allowlist de modelos opcional
deliveryPolicystring | nullauto, verified, official, nullnull herda a política de entrega do Workspace.
expiresAtstring | nulldata e hora RFC3339null significa sem expiração

Observações

  • Campos monetários são apenas em USD. Entradas em CNY foram descontinuadas e retornam 400 currency_retired.

  • models: [] não adiciona restrição de modelos no nível da chave.

  • limitAmount: 0 cria uma chave válida, mas que não pode gastar cota até ser atualizada.

Exemplo

Requisição

cURL
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.

Exemplo de resposta

Resposta

201 Created
{
  "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

keystring
Valor completo do segredo da API key. Ele é retornado apenas uma vez na criação.
idstring
Identificador da API key utilizado em chamadas subsequentes da Management API.
namestring
Nome de exibição para a API key.
key_prefixstring
Prefixo não confidencial da chave para exibição e suporte.
statusstring
Um entre active, inactive, suspended ou revoked.
limit_amountnumber | null
Limite de gastos em USD como um número JSON para exibição. null significa ilimitado.
limit_amount_decimalstring | null
Limite exato de gastos em USD como uma string decimal. null significa ilimitado.
used_amountnumber
Uso acumulado em USD como um número JSON para exibição.
used_amount_decimalstring
Uso acumulado exato em USD como uma string decimal.
modelsstring[]
Allowlist de modelos por chave. Um array vazio significa nenhuma restrição adicional de modelos no nível da chave.
delivery_policystring | null
auto, verified, official, null. null herda a política de entrega do Workspace.
expires_atstring | null
Timestamp ISO de quando a chave expira, ou null para sem expiração.
last_used_atstring | null
Timestamp ISO para o uso mais recente, ou null quando não utilizada.
created_atstring
Timestamp ISO de criação.

Autorização

ManagementTokenAuth
AuthorizationBearer <token>

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