Autenticação

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

Faça login no seu Painel TokenLab
Abra API Keys
Crie uma nova chave
Dê a ela um nome descritivo
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!"
  }'

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("TOKENLAB_API_KEY"),
    base_url="https://api.tokenlab.sh/v1"
)

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.TOKENLAB_API_KEY,
  baseURL: 'https://api.tokenlab.sh/v1'
});

Recursos das chaves de API

Limites de uso

Você pode definir um limite de uso para cada chave de API:

Configuração	Descrição
Sem limite	A chave usa o saldo da sua conta sem restrições
Limite fixo	A 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 status	Tipo	Código	Descrição
401	`invalid_api_key`	`invalid_api_key`	Chave de API ausente ou inválida
401	`expired_api_key`	`expired_api_key`	A chave de API foi revogada
402	`insufficient_balance`	`insufficient_balance`	O saldo da conta é insuficiente
402	`quota_exceeded`	`quota_exceeded`	O limite de uso da chave de API foi atingido

Exemplo:

{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_api_key",
    "code": "invalid_api_key"
  }
}

Primeiros passos

Guias principais

Guias de mídia

Chaves de API

Obtendo sua chave de API

Usando chaves de API

Recursos das chaves de API

Limites de uso

Prefixo da chave

Compatibilidade com Anthropic

Respostas de erro

​Chaves de API

​Obtendo sua chave de API

​Usando chaves de API

​Recursos das chaves de API

​Limites de uso

​Prefixo da chave

​Compatibilidade com Anthropic

​Respostas de erro

Chaves de API

Obtendo sua chave de API

Usando chaves de API

Recursos das chaves de API

Limites de uso

Prefixo da chave

Compatibilidade com Anthropic

Respostas de erro