Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

​
Claves API

Todas las solicitudes a la API de TokenLab requieren una clave API. Para los endpoints compatibles con OpenAI, envíala como: 
Authorization: Bearer sk-your-api-key
Para las solicitudes compatibles con Anthropic a /v1/messages, también puedes usar: 
x-api-key: sk-your-api-key

​
Obtener tu clave API

  1. Inicia sesión en tu TokenLab Dashboard
  2. Abre API Keys
  3. Crea una nueva clave
  4. Asígnale un nombre descriptivo
  5. 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

curl https://api.tokenlab.sh/v1/responses \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "input": "Hello!"
  }'

​
Características de las claves API

​
Límites de uso

Puedes establecer un límite de uso en cada clave API:
ConfiguraciónDescripción
Sin límiteLa clave usa el saldo de tu cuenta sin restricciones
Límite fijoLa clave deja de funcionar después de alcanzar la cantidad especificada

​
Prefijo de clave

Todas las claves API de TokenLab comienzan con sk-.

​
Compatibilidad con Anthropic

Para el endpoint /v1/messages, el encabezado de estilo Anthropic funciona como se espera: 
curl https://api.tokenlab.sh/v1/messages \
  -H "x-api-key: sk-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'
Usa Authorization: Bearer ... para endpoints compatibles con OpenAI como /v1/responses, /v1/chat/completions, /v1/models y la mayoría de las demás rutas de TokenLab.

​
Respuestas de error

Código de estadoTipoCódigoDescripción
401invalid_api_keyinvalid_api_keyFalta la clave API o no es válida
401expired_api_keyexpired_api_keyLa clave API ha sido revocada
402insufficient_balanceinsufficient_balanceEl saldo de la cuenta es insuficiente
402quota_exceededquota_exceededSe 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"
  }
}