Referencia de la API de Gemini

En esta referencia de la API, se describen las APIs unarias, de transmisión y en tiempo real que puedes usar para interactuar con los modelos de Gemini. Puedes usar las APIs de REST en cualquier entorno que admita solicitudes HTTP. Consulta la Guía de introducción para comenzar a usar tu primera llamada a la API. Si buscas las referencias de nuestras bibliotecas y SDKs específicos del lenguaje, ve al vínculo de ese lenguaje en la navegación de la izquierda en Referencias del SDK.

Extremos principales

La API de Gemini se organiza en torno a los siguientes extremos principales:

• Interacciones (CreateInteraction) (recomendado): Es la primitiva estándar recomendada para compilar con Gemini, optimizada para flujos de trabajo de agentes, administración de estados del servidor y conversaciones complejas de varios turnos y multimodales.
• Generación de contenido estándar (generateContent): Es un extremo de REST estándar que procesa tu solicitud y muestra la respuesta completa del modelo en un solo paquete. Es mejor para tareas no interactivas en las que puedes esperar el resultado completo.
• Generación de contenido de transmisión (streamGenerateContent): Usa eventos enviados por el servidor (SSE) para enviarte fragmentos de la respuesta a medida que se generan. Esto proporciona una experiencia más rápida e interactiva para aplicaciones como chatbots.
• API en vivo (BidiGenerateContent): Es una API con estado basada en WebSocket para la transmisión bidireccional, diseñada para casos de uso conversacionales en tiempo real.
• Modo por lotes (batchGenerateContent): Es un extremo de REST estándar para enviar lotes de solicitudes generateContent.
• Incorporaciones (embedContent): Es un extremo de REST estándar que genera un vector de incorporación de texto a partir de la Content de entrada.
• APIs de Gen Media: Son extremos para generar contenido multimedia con nuestros modelos especializados como Imagen para la generación de imágenes, y Veo para la generación de videos. Gemini también tiene estas capacidades integradas a las que puedes acceder con la API de generateContent.
• APIs de la plataforma: Son extremos de utilidad que admiten capacidades principales, como subir archivos y contar tokens.

Autenticación

Todas las solicitudes a la API de Gemini deben incluir un encabezado x-goog-api-key con tu clave de API. Crea una con unos pocos clics en Google AI Studio.

A continuación, se muestra un ejemplo de solicitud con la clave de API incluida en el encabezado:

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "Explain how AI works in a few words"
          }
        ]
      }
    ]
  }'

Para obtener instrucciones sobre cómo pasar tu clave a la API con los SDKs de Gemini, consulta la guía Usa claves de API de Gemini.