Administración
Crear API Key
Crea una API key para el Workspace actual.
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
| Campo | Tipo | Predeterminado / Límites | Notas |
|---|---|---|---|
name | string | opcional, predeterminado Default Key, longitud 1-50 | Nombre para mostrar, recortado en el lado del servidor |
limitAmount | number | string | null | 0–100000 USD | null significa ilimitado; 0 evita el gasto. Las cadenas decimales admiten hasta 6 decimales. Omitir este campo al crear una key significa ilimitado. |
limitCurrency | enum | predeterminado USD | Solo USD. El envío de CNY devuelve 400 currency_retired. |
models | string[] | predeterminado [] | Lista de modelos permitidos opcional |
deliveryPolicy | string | null | auto, verified, official, null | null hereda la política de entrega del Workspace. |
expiresAt | string | null | fecha y hora RFC3339 | null significa que no caduca |
Notas
-
Los campos monetarios son solo en USD. Las entradas en
CNYestán obsoletas y devuelven400 currency_retired. -
models: []no añade ninguna restricción de modelos a nivel de key. -
limitAmount: 0crea una key que es válida pero no puede gastar cuota hasta que se actualice.
Solicitud
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.
Respuesta
{
"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 o revoked.null significa ilimitado.null significa ilimitado.auto, verified, official, null. null hereda la política de entrega del Workspace.null si no tiene caducidad.null cuando no se ha utilizado.Autorización
ManagementTokenAuth 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