Saltar al contenido principal

​
Claves de API

Todas las solicitudes de API requieren autenticación mediante una clave de API. Incluya su clave en el encabezado Authorization: 
Authorization: Bearer sk-your-api-key

​
Cómo obtener su clave de API

  1. Inicie sesión en su LemonData Dashboard
  2. Navegue a la sección API Keys
  3. Haga clic en Create New Key
  4. Asigne un nombre descriptivo a su clave
  5. Copie la clave de inmediato; solo se muestra una vez
Mejores prácticas de seguridad:
  • Nunca exponga las claves de API en el código del lado del cliente
  • No suba las claves al control de versiones
  • Utilice variables de entorno para almacenar las claves
  • Rote las claves periódicamente
  • Elimine las claves que no utilice

​
Uso de claves 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!"}]}'

​
Características de las claves de API

​
Límites de uso

Puede establecer un límite de uso en cada clave de API para controlar el gasto:
ConfiguraciónDescripción
Sin límiteLa clave utiliza el saldo de su cuenta sin restricciones
Límite fijoLa clave deja de funcionar tras alcanzar el importe especificado

​
Prefijo de la clave

Todas las claves de API de LemonData comienzan con el prefijo sk-. El formato de la clave es: 
sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

​
Compatibilidad con la API de Anthropic

Para el endpoint /v1/messages, puede utilizar el encabezado x-api-key (compatible con el SDK de 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!"}]
  }'
El encabezado x-api-key solo es compatible con los endpoints /v1/messages y /v1/messages/count_tokens. Otros endpoints requieren el encabezado Authorization: Bearer.

​
Respuestas de error

Código de estadoTipoCódigoDescripción
401invalid_request_errorinvalid_api_keyClave de API faltante o no válida
401invalid_request_errorexpired_api_keyLa clave de API ha sido revocada
402insufficient_quotainsufficient_quotaEl saldo de la cuenta es insuficiente
402insufficient_quotaquota_exceededSe ha alcanzado el límite de uso de la clave de API
Ejemplo de respuesta de error: 
{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_api_key",
    "code": "invalid_api_key"
  }
}