Autenticação

Proteja cada requisição com um token portador usando sua chave API do EmpirioLabs

Todas as requisições da API do EmpirioLabs devem incluir um token portador no cabeçalho Authorization.

Formato da chave API

Chaves de API usam o prefixo sk-empiriolabs-. Você pode gerar até 50 chaves de API por conta a partir do painel.

1Authorization: Bearer sk-empiriolabs-...

Formato do cabeçalho

Inclua o cabeçalho em cada solicitação:

$curl "https://api.empiriolabs.ai/v1/models" \
> -H "Authorization: Bearer sk-empiriolabs-your_key_here"

Limites de taxa

Cada conta começa com limites de taxa padrão:

LimitePadrão
Pedidos por minuto50 RPM
Tokens por minuto2.000.000 TPM

Se precisar de limites mais altos, envie um e-mail para support@empiriolabs.ai. Veja Limites e Chaves de API para detalhes completos.

Práticas recomendadas

  • Gerar chaves de API separadas para produção, staging e desenvolvimento
  • Gire as chaves em um cronograma regular e imediatamente após suspeita de exposição
  • Armazene chaves em um gerenciador secreto ou plataforma de implantação - nunca em código do lado do cliente, repositórios públicos ou logs
  • Exclua as chaves não utilizadas do painel rapidamente

Teste suas credenciais

Uma maneira rápida de verificar se sua chave está funcionando:

$curl "https://api.empiriolabs.ai/v1/models" \
> -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Uma resposta 200 com o catálogo de modelos confirma que sua chave é válida e que sua conta foi configurada corretamente.

Respostas comuns de autenticação

Código de statusSignificadoO que fazer
401 UnauthorizedO token está ausente, deformado ou não encontradoVerifique o formato do cabeçalho Authorization: Bearer sk-empiriolabs-... e se a chave existe no seu painel
402 Payment RequiredA conta tem créditos insuficientesCréditos de recarga no painel Página de Faturamento
429 Too Many RequestsLimite de taxa ultrapassado (padrão de 50 RPM)Tente novamente com recuo exponencial e revise o volume de solicitações