Referência da API Gemini

Esta referência da API descreve as APIs unárias, de streaming e em tempo real que você pode usar para interagir com os modelos do Gemini. É possível usar as APIs REST em qualquer ambiente que ofereça suporte a solicitações HTTP. Consulte o guia de início rápido para saber como começar a fazer sua primeira chamada de API. Se você estiver procurando as referências das nossas bibliotecas e SDKs específicos de linguagem, acesse o link desse idioma na navegação à esquerda em Referências de SDK.

Endpoints principais

A API Gemini é organizada em torno dos seguintes endpoints principais:

• Interações (CreateInteraction) (recomendado): a primitiva padrão recomendada para criar com o Gemini, otimizada para fluxos de trabalho agênticos, gerenciamento de estado do lado do servidor e conversas complexas multimodais e multiturno.
• Geração de conteúdo padrão (generateContent): um endpoint REST padrão que processa sua solicitação e retorna a resposta completa do modelo em um único pacote. Isso é melhor para tarefas não interativas em que você pode esperar o resultado completo.
• Geração de conteúdo por streaming (streamGenerateContent): usa eventos enviados pelo servidor (SSE) para enviar partes da resposta conforme elas são geradas. Isso oferece uma experiência mais rápida e interativa para aplicativos como chatbots.
• API Live (BidiGenerateContent): uma API com estado baseada em WebSocket para streaming bidirecional, projetada para casos de uso de conversação em tempo real.
• Modo em lote (batchGenerateContent): um endpoint REST padrão para enviar lotes de solicitações generateContent.
• Embeddings (embedContent): um endpoint REST padrão que gera um vetor de embedding de texto da entrada Content.
• APIs Gen Media:endpoints para gerar mídia com nossos modelos especializados, como Imagen para geração de imagens e Veo para geração de vídeos. O Gemini também tem esses recursos integrados, que podem ser acessados usando a API generateContent.
• APIs de plataforma:endpoints de utilidade que oferecem suporte a recursos principais, como upload de arquivos e contagem de tokens.

Autenticação

Todas as solicitações para a API Gemini precisam incluir um cabeçalho x-goog-api-key com sua chave de API. Crie uma com alguns cliques no Google AI Studio.

Confira abaixo um exemplo de solicitação com a chave de API incluída no cabeçalho:

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 instruções sobre como transmitir sua chave para a API usando os SDKs do Gemini, consulte o guia Como usar chaves de API do Gemini.