Criar chave API

Visão geralCopy Anchor Link

Este endpoint cria uma nova API Key type=user na organização associada ao token de gerenciamento atual.

Corpo da requisiçãoCopy Anchor Link

ObservaçõesCopy Anchor Link

• Os campos monetários aceitam apenas USD. Entradas em CNY foram descontinuadas e retornam 400 currency_retired.

• O valor completo da API Key aparece apenas uma vez na resposta.

• models: [] significa que a chave não possui restrição adicional de modelos além da política da organização.

• limitAmount: 0 cria uma chave válida, mas sem quota utilizável até que seja atualizada.

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-3.0-video"],
    "expiresAt": "2026-12-31T23:59:59Z"
  }'

Requisição / RespostaCopy Anchor Link

Esta página fornece o esquema OpenAPI e exemplos de requisições para copiar. Envie solicitações de gerenciamento pelo terminal ou cliente usando um Management Token; o envio direto não está disponível nesta página.

{
  "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-3.0-video"
  ],
  "expires_at": "2026-12-31T23:59:59.000Z",
  "last_used_at": null,
  "created_at": "2026-07-08T03:00:00.000Z",
  "delivery_policy": null
}

Campos importantesCopy Anchor Link