Saltar para o conteúdo principal

​
Chaves de API

Todas as requisições de API exigem autenticação usando uma chave de API. Inclua sua chave no cabeçalho Authorization: 
Authorization: Bearer sk-your-api-key

​
Obtendo sua Chave de API

  1. Faça login no seu LemonData Dashboard
  2. Navegue até a seção API Keys
  3. Clique em Create New Key
  4. Dê um nome descritivo para sua chave
  5. Copie a chave imediatamente - ela é exibida apenas uma vez
Melhores Práticas de Segurança:
  • Nunca exponha chaves de API em código do lado do cliente (client-side)
  • Não envie chaves para sistemas de controle de versão
  • Use variáveis de ambiente para armazenar chaves
  • Rotacione as chaves periodicamente
  • Exclua chaves não utilizadas

​
Usando Chaves de API

curl https://api.lemondata.cc/v1/chat/completions \
  -H "Authorization: Bearer $LEMONDATA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "Hello!"}]}'

​
Recursos da Chave de API

​
Limites de Uso

Você pode definir um limite de uso em cada chave de API para controlar os gastos:
ConfiguraçãoDescrição
No LimitA chave usa o saldo da sua conta sem restrições
Fixed LimitA chave para de funcionar após atingir o valor especificado

​
Prefixo da Chave

Todas as chaves de API da LemonData começam com o prefixo sk-. O formato da chave é: 
sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

​
Compatibilidade com a API da Anthropic

Para o endpoint /v1/messages, você pode usar o cabeçalho x-api-key (compatível com o SDK da Anthropic): 
curl https://api.lemondata.cc/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-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'
O cabeçalho x-api-key é suportado apenas nos endpoints /v1/messages e /v1/messages/count_tokens. Outros endpoints exigem o cabeçalho Authorization: Bearer.

​
Respostas de Erro

Código de StatusTipoCódigoDescrição
401invalid_request_errorinvalid_api_keyChave de API ausente ou inválida
401invalid_request_errorexpired_api_keyA chave de API foi revogada
402insufficient_quotainsufficient_quotaO saldo da conta é insuficiente
402insufficient_quotaquota_exceededLimite de uso da chave de API atingido
Exemplo de resposta de erro: 
{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_api_key",
    "code": "invalid_api_key"
  }
}