Saltar para o conteúdo 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.

​
Chaves de API

Todas as requisições à API TokenLab exigem uma chave de API. Para endpoints compatíveis com OpenAI, envie-a como: 
Authorization: Bearer sk-your-api-key
Para requisições compatíveis com Anthropic em /v1/messages, você também pode usar: 
x-api-key: sk-your-api-key

​
Obtendo sua chave de API

  1. Faça login no seu Painel TokenLab
  2. Abra API Keys
  3. Crie uma nova chave
  4. Dê a ela um nome descritivo
  5. Copie-a imediatamente, porque ela é exibida apenas uma vez
  • Nunca exponha chaves de API em código client-side
  • Nunca faça commit de chaves de API no controle de versão
  • Use variáveis de ambiente ou um gerenciador de segredos
  • Faça a rotação das chaves periodicamente
  • Exclua chaves não utilizadas

​
Usando chaves de 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!"
  }'

​
Recursos das chaves de API

​
Limites de uso

Você pode definir um limite de uso para cada chave de API:
ConfiguraçãoDescrição
Sem limiteA chave usa o saldo da sua conta sem restrições
Limite fixoA chave para de funcionar após atingir o valor especificado

​
Prefixo da chave

Todas as chaves de API da TokenLab começam com sk-.

​
Compatibilidade com Anthropic

Para o endpoint /v1/messages, o header no estilo Anthropic funciona conforme esperado: 
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!"}]
  }'
Use Authorization: Bearer ... para endpoints compatíveis com OpenAI, como /v1/responses, /v1/chat/completions, /v1/models e a maioria das outras rotas da TokenLab.

​
Respostas de erro

Código de statusTipoCódigoDescrição
401invalid_api_keyinvalid_api_keyChave de API ausente ou inválida
401expired_api_keyexpired_api_keyA chave de API foi revogada
402insufficient_balanceinsufficient_balanceO saldo da conta é insuficiente
402quota_exceededquota_exceededO limite de uso da chave de API foi atingido
Exemplo: 
{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_api_key",
    "code": "invalid_api_key"
  }
}