Administración

Crear API Key

Crea una API key para el Workspace actual.

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

Descripción general

Crea una API key en el Workspace asociado con el token de administración. El secreto completo aparece una sola vez, en esta respuesta.

Cuerpo de la solicitud

CampoTipoPredeterminado / LímitesNotas
namestringopcional, predeterminado Default Key, longitud 1-50Nombre para mostrar, recortado en el lado del servidor
limitAmountnumber | string | null0–100000 USDnull significa ilimitado; 0 evita el gasto. Las cadenas decimales admiten hasta 6 decimales. Omitir este campo al crear una key significa ilimitado.
limitCurrencyenumpredeterminado USDSolo USD. El envío de CNY devuelve 400 currency_retired.
modelsstring[]predeterminado []Lista de modelos permitidos opcional
deliveryPolicystring | nullauto, verified, official, nullnull hereda la política de entrega del Workspace.
expiresAtstring | nullfecha y hora RFC3339null significa que no caduca

Notas

  • Los campos monetarios son solo en USD. Las entradas en CNY están obsoletas y devuelven 400 currency_retired.

  • models: [] no añade ninguna restricción de modelos a nivel de key.

  • limitAmount: 0 crea una key que es válida pero no puede gastar cuota hasta que se actualice.

Ejemplo

Solicitud

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"
  }'

Solicitud / Respuesta

Esta página proporciona el esquema de OpenAPI y ejemplos de solicitudes copiables. Envía solicitudes de administración desde tu terminal o cliente con un Management Token; el envío directo no está disponible en esta página.

Ejemplo de respuesta

Respuesta

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 secreto completo de la API key. Se devuelve una sola vez al momento de la creación.
idstring
Identificador de la API key utilizado en las llamadas posteriores a la Management API.
namestring
Nombre para mostrar de la API key.
key_prefixstring
Prefijo no secreto de la key para visualización y soporte técnico.
statusstring
Uno de active, inactive, suspended o revoked.
limit_amountnumber | null
Límite de gasto en USD como un número JSON para su visualización. null significa ilimitado.
limit_amount_decimalstring | null
Límite de gasto exacto en USD como una cadena decimal. null significa ilimitado.
used_amountnumber
Uso acumulado en USD como un número JSON para su visualización.
used_amount_decimalstring
Uso acumulado exacto en USD como una cadena decimal.
modelsstring[]
Lista de modelos permitidos por key. Un array vacío significa que no hay restricciones adicionales de modelos a nivel de key.
delivery_policystring | null
auto, verified, official, null. null hereda la política de entrega del Workspace.
expires_atstring | null
Marca de tiempo ISO en la que caduca la key, o null si no tiene caducidad.
last_used_atstring | null
Marca de tiempo ISO para el uso más reciente, o null cuando no se ha utilizado.
created_atstring
Marca de tiempo ISO de creación.

Autorización

ManagementTokenAuth
AuthorizationBearer <token>

Autenticación con Management Token. Cree o gestione Management Tokens en Dashboard > API > Management Tokens.

Ubicación: header

Cuerpo de la solicitud

application/json

Respuesta

application/json

application/json

application/json

application/json