Chaves de API
Todas as requisições à API LemonData exigem uma chave de API.
Para endpoints compatíveis com OpenAI, envie-a como:
Authorization: Bearer sk-your-api-key
/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 LemonData
- 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.lemondata.cc/v1/responses \
-H "Authorization: Bearer $LEMONDATA_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:
| Setting | Description |
|---|
| 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 LemonData começam com sk-.
Para o endpoint /v1/messages, o header no estilo Anthropic funciona conforme esperado:
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-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 LemonData.
Respostas de erro
| Status Code | Type | Code | Description |
|---|
| 401 | invalid_request_error | invalid_api_key | Chave de API ausente ou inválida |
| 401 | invalid_request_error | expired_api_key | A chave de API foi revogada |
| 402 | insufficient_quota | insufficient_quota | O saldo da conta é insuficiente |
| 402 | insufficient_quota | quota_exceeded | O limite de uso da chave de API foi atingido |
{
"error": {
"message": "Invalid API key provided",
"type": "invalid_api_key",
"code": "invalid_api_key"
}
}
