Español – América Latina Português – Brasil Referência da API 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 . 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: 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 . Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons , e as amostras de código são licenciadas de acordo com a Licença Apache 2.0 . Para mais detalhes, consulte as políticas do site do Google Developers . Java é uma marca registrada da Oracle e/ou afiliadas. Última atualização 2026-09-08 UTC.