Administración
Crear API Key
Crea una nueva API Key de usuario para la organización actual.
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
| Campo | Tipo | Valor predeterminado / límites | Notas |
|---|---|---|---|
name | string | opcional, predeterminado Default Key, longitud 1-50 | Nombre visible, recortado en el servidor |
limitAmount | number | string | null | 0–100000 USD | null 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. |
limitCurrency | enum | predeterminado USD | Solo USD. Enviar CNY devuelve 400 currency_retired. |
models | string[] | predeterminado [] | Lista opcional de modelos lógicos permitidos |
deliveryPolicy | string | null | auto, verified, official, null | null hereda la política de entrega del espacio de trabajo. |
expiresAt | string | null | datetime RFC3339 | null significa sin caducidad |
Notas
-
Los campos monetarios solo admiten USD. Las entradas
CNYestán retiradas y devuelven400 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: 0crea una clave válida pero sin cuota utilizable 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-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.
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-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
active, inactive, suspended o revoked.null significa sin límite.null significa sin límite.auto, verified, official, null. null hereda la política de entrega del espacio de trabajo.null si no caduca.null si nunca se ha usado.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