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 realizar tu primera llamada a la API. Si buscas las referencias de nuestros SDKs y bibliotecas 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 endpoints principales:

• Interactions (CreateInteraction) (recomendado): Es el elemento fundamental estándar recomendado para compilar con Gemini, optimizado para flujos de trabajo de agentes, administración de estados del servidor y conversaciones complejas multimodales y de varios turnos.
• Generación de contenido estándar (generateContent): Es un extremo REST estándar que procesa tu solicitud y devuelve la respuesta completa del modelo en un solo paquete. Es ideal 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 los chatbots.
• Live API (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 REST estándar para enviar lotes de solicitudes generateContent.
• Embeddings (embedContent): Es un endpoint REST estándar que genera un vector de embedding de texto a partir de la entrada Content.
• 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 la carga de archivos y el recuento de 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 Cómo usar claves de la API de Gemini.