Saltar al contenido principal
LemonData es compatible con el formato nativo de la API de Google Gemini para los modelos Gemini. Esto permite una compatibilidad directa con los SDK de Google AI.

Parámetros de Ruta

model
string
requerido
Nombre del modelo (por ejemplo, gemini-2.5-pro, gemini-2.5-flash).

Parámetros de Consulta

key
string
Clave API (alternativa a la autenticación por encabezado).

Autenticación

Los endpoints de Gemini admiten múltiples métodos de autenticación:
  • Parámetro de consulta ?key=YOUR_API_KEY
  • Encabezado x-goog-api-key: YOUR_API_KEY
  • Encabezado Authorization: Bearer YOUR_API_KEY

Cuerpo de la Solicitud

contents
array
requerido
Contenidos de la conversación.Cada objeto de contenido contiene:
  • role (string): user o model
  • parts (array): Partes del contenido (texto o datos en línea)
systemInstruction
object
Instrucción del sistema para el modelo.
generationConfig
object
Configuración de generación:
  • temperature (number): Temperatura de muestreo
  • topP (number): Probabilidad de muestreo de núcleo (nucleus sampling)
  • topK (integer): Muestreo Top-K
  • maxOutputTokens (integer): Máximo de tokens de salida
  • stopSequences (array): Secuencias de parada
safetySettings
array
Configuración de filtros de seguridad.

Respuesta

candidates
array
Candidatos de contenido generado.
usageMetadata
object
Información de uso de tokens.
curl -X POST "https://api.lemondata.cc/v1beta/models/gemini-2.5-pro:generateContent?key=sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "parts": [{"text": "Hello, Gemini!"}]
      }
    ],
    "generationConfig": {
      "temperature": 0.7,
      "maxOutputTokens": 1024
    }
  }'

Vision Input Example

For Gemini vision requests, place images inside contents[].parts[] as structured inline_data parts. The data field should contain Base64-encoded file bytes, and mime_type should match the uploaded image format.
{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Please describe this image." },
        {
          "inline_data": {
            "mime_type": "image/jpeg",
            "data": "/9j/4AAQSkZJRgABAQ..."
          }
        }
      ]
    }
  ]
}
{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {"text": "Hello! How can I assist you today?"}
        ]
      },
      "finishReason": "STOP",
      "safetyRatings": [
        {"category": "HARM_CATEGORY_HARASSMENT", "probability": "NEGLIGIBLE"}
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 5,
    "candidatesTokenCount": 10,
    "totalTokenCount": 15
  }
}