Referência da API Gemini

Esta referência da API descreve as APIs unárias, de streaming e em tempo real que podem ser usadas 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 usar sua primeira chamada de API. Se você estiver procurando as referências das nossas bibliotecas e SDKs específicos para idiomas, acesse o link do idioma na navegação à esquerda em Referências do 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 de agentes, gerenciamento de estado do lado do servidor e conversas multimodais, multiturno complexas.
• 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. Essa opção é mais adequada para tarefas não interativas em que você pode esperar o resultado completo.
• Geração de conteúdo de streaming (streamGenerateContent): usa eventos enviados pelo servidor (SSE) para enviar blocos da resposta à medida que são gerados. 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 conversacionais 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 Content de entrada.
• APIs Gen Media: endpoints para gerar mídia com nossos modelos especializados como o Imagen para geração de imagens, e o Veo para geração de vídeos. O Gemini também tem esses recursos integrados, que podem ser acessados usando a API generateContent.
• APIs da plataforma: endpoints de utilitários 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 a seguir 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 da API Gemini.