Primeros pasos
Autenticación
Protege tus solicitudes a la API de TokenLab con claves API
Claves API
Las llamadas a modelos y los recursos privados requieren una clave API. Los endpoints públicos como GET /v1/models y GET /v1/models/{model} funcionan sin ella. Una consulta de descubrimiento correcta no valida la clave; sigue el inicio rápido para enviar una solicitud al modelo. Usa la clave completa guardada, no el prefijo de la lista.
Para los endpoints compatibles con OpenAI, envíala como:
Authorization: Bearer sk-your-api-keyPara las solicitudes compatibles con Anthropic a /v1/messages, también puedes usar:
x-api-key: sk-your-api-keyTokens de gestión
Los endpoints de la API de gestión usan un tipo de token distinto:
Authorization: Bearer mt-your-management-tokenUsa los tokens de gestión solo con /v1/management/*. Abre API → Tokens en el espacio de trabajo seleccionado para crear o reemplazar un token. Guarda el token completo de forma segura; solo se muestra una vez después de crearlo o reemplazarlo.
Los tokens de gestión no sirven para inferencia de modelos, y las claves API normales sk-... no sirven para la API de gestión.
Obtener tu clave API
- Inicia sesión en tu TokenLab Dashboard
- Abre API Keys
- Crea una nueva clave
- Asígnale un nombre descriptivo
- Cópiala inmediatamente porque se muestra solo una vez
- Nunca expongas claves API en código del lado del cliente
- Nunca subas claves API al control de versiones
- Usa variables de entorno o un gestor de secretos
- Rota las claves periódicamente
- Elimina las claves sin usar
Uso de claves API
Consulta el inicio rápido para las variables de entorno y una primera solicitud completa. Usa el SDK correspondiente al formato API y guarda las claves en el servidor.
Características de las claves API
Límites de uso
Puedes establecer un límite de uso en cada clave API:
| Configuración | Descripción |
|---|---|
| Sin límite | La clave usa el saldo de tu cuenta sin restricciones |
| Límite fijo | La clave deja de funcionar después de alcanzar la cantidad especificada |
Prefijo de clave
Todas las claves API de TokenLab comienzan con sk-.
Respuestas de error
| Código de estado | Tipo | Código | Descripción |
|---|---|---|---|
| 401 | invalid_api_key | invalid_api_key | La clave API falta, no es válida, está inactiva o fue revocada |
| 401 | expired_api_key | expired_api_key | La clave API ha caducado |
| 402 | insufficient_balance | insufficient_balance | El saldo de la cuenta es insuficiente |
| 402 | quota_exceeded | quota_exceeded | Se alcanzó el límite de uso de la clave API |
Ejemplo:
{
"error": {
"message": "Invalid API key provided",
"type": "invalid_api_key",
"code": "invalid_api_key"
}
}