Administración

Crear API Key

Crea una nueva API Key de usuario para la organización actual.

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

Resumen

Este endpoint crea una nueva API Key de tipo type=user en la organización asociada al token de gestión actual.

Cuerpo de la solicitud

CampoTipoValor predeterminado / límitesNotas
namestringopcional, predeterminado Default Key, longitud 1-50Nombre visible, recortado en el servidor
limitAmountnumber | string | null0–100000 USDnull significa sin límite; 0 impide el gasto. Las cadenas decimales admiten hasta 6 decimales. Al crear la clave, omitir este campo significa sin límite.
limitCurrencyenumpredeterminado USDSolo USD. Enviar CNY devuelve 400 currency_retired.
modelsstring[]predeterminado []Lista opcional de modelos lógicos permitidos
deliveryPolicystring | nullauto, verified, official, nullnull hereda la política de entrega del espacio de trabajo.
expiresAtstring | nulldatetime RFC3339null significa sin caducidad

Notas

  • Los campos monetarios solo admiten USD. Las entradas CNY están retiradas y devuelven 400 currency_retired.

  • El valor completo de la API key solo se muestra una vez en la respuesta.

  • models: [] significa que la clave no tiene restricciones adicionales de modelo más allá de la política de la organización.

  • limitAmount: 0 crea una clave válida pero sin cuota utilizable 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-3.0-video"],
    "expiresAt": "2026-12-31T23:59:59Z"
  }'

Solicitud / Respuesta

Esta página ofrece el esquema OpenAPI y ejemplos de solicitudes que puedes copiar. Envía las solicitudes de gestión desde tu terminal o cliente con un Management Token; esta página no permite enviarlas directamente.

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-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 importantes

keystring
Valor secreto completo de la clave API. Solo se devuelve una vez al crearla.
idstring
Identificador de clave API usado en llamadas posteriores a la API de gestión.
namestring
Nombre para mostrar de la clave API.
key_prefixstring
Prefijo de clave no secreto para visualización y soporte.
statusstring
Uno de los valores active, inactive, suspended o revoked.
limit_amountnumber | null
Límite de gasto en USD como número JSON para visualización. null significa sin límite.
limit_amount_decimalstring | null
Límite de gasto exacto en USD como cadena decimal. null significa sin límite.
used_amountnumber
Gasto de uso acumulado en USD como número JSON para visualización.
used_amount_decimalstring
Gasto de uso acumulado exacto en USD como cadena decimal.
modelsstring[]
Lista de modelos permitidos por clave. Un array vacío significa que no hay una restricción adicional de modelos a nivel de clave.
delivery_policystring | null
auto, verified, official, null. null hereda la política de entrega del espacio de trabajo.
expires_atstring | null
Marca de tiempo ISO en la que vence la clave, o null si no caduca.
last_used_atstring | null
Marca de tiempo ISO del uso más reciente, o null si nunca se ha usado.
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