Repolode
Enviar
google-gemini-php

google-gemini-php/client

Cliente PHP mantido pela comunidade para a Gemini API, com suporte a texto, mídia, streaming, ferramentas e gerenciamento de arquivos e cache.

Ver no GitHub
Estrelas
412
Forks
83
Issues abertas
2
Último commit
há 26 dias

O que é?

Gemini PHP é um cliente de API em PHP mantido pela comunidade para a Gemini API do Google. Ele permite que aplicações PHP enviem texto e conteúdo de imagem, vídeo, áudio e documentos aos modelos Gemini, além de oferecer suporte a streaming, conversas com várias interações, saída JSON estruturada e chamadas de função.

O cliente também encapsula ferramentas integradas, como Google Search, Google Maps, contexto de URL, File Search e execução de código, além de geração de imagens e fala e configuração de modelos de raciocínio. Arquivos, cache de contexto, repositórios do File Search, embeddings e listagem de modelos ficam disponíveis por meio de métodos específicos.

Requer PHP 8.2 ou mais recente, é instalado via Composer e inclui um cliente falso para escrever testes sem chamar a API em produção.

Recursos principais

  • 01Aceita entradas de texto, imagem, vídeo, áudio e documentos.
  • 02Oferece respostas em streaming e sessões de chat com várias interações.
  • 03Retorna saídas JSON estruturadas usando esquemas ou arrays JSON Schema.
  • 04Inclui chamadas de função e ferramentas integradas, como Google Search e execução de código.
  • 05Oferece envio de arquivos, cache de contexto e repositórios do File Search.
  • 06Inclui um cliente falso para testes.

Casos de uso

  • Adicionar chat ou geração de conteúdo com Gemini a um backend Laravel ou a outro backend em PHP.
  • Extrair dados estruturados de documentos ou imagens para JSON tipado.
  • Criar respostas com geração aumentada por recuperação sobre documentos enviados, usando File Search.
  • Escrever testes unitários para código PHP que chama Gemini sem acessar a API em produção.

Início rápido

  1. 1

    Instale o pacote para PHP 8.2 ou superior com o Composer

    composer require google-gemini-php/client
  2. 2

    Instale um cliente HTTP PSR-18 se o seu projeto não tiver um

    composer require guzzlehttp/guzzle
  3. 3

    Crie uma chave de API do Gemini no Google AI Studio

  4. 4

    Crie o cliente com sua chave de API e chame generateContent em gemini-2.5-flash

Antes de usar

  • É necessário usar PHP 8.2 ou superior.
  • É necessária uma chave de API do Gemini do Google AI Studio.
  • A versão 2.0 funciona apenas com a API Gemini v1beta.

Tópicos

#gemini#php#llm#google-ai#sdk#api-client#structured-output#gemini-api#google-ai-client-sdk#google-ai-studio

Perguntas frequentes

O que é client?
Cliente PHP mantido pela comunidade para a Gemini API, com suporte a texto, mídia, streaming, ferramentas e gerenciamento de arquivos e cache. Gemini PHP é um cliente de API em PHP mantido pela comunidade para a Gemini API do Google. Ele permite que aplicações PHP enviem texto e conteúdo de imagem, vídeo, áudio e documentos aos modelos Gemini, além de oferecer suporte a streaming, conversas com várias interações, saída JSON estruturada e chamadas de função.
client é gratuito? Qual é a licença?
client é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
client ainda é mantido?
Manutenção ativa. O último commit de client foi em 12 de out. de 2026.
Para que posso usar client?
Adicionar chat ou geração de conteúdo com Gemini a um backend Laravel ou a outro backend em PHP. Extrair dados estruturados de documentos ou imagens para JSON tipado. Criar respostas com geração aumentada por recuperação sobre documentos enviados, usando File Search. Escrever testes unitários para código PHP que chama Gemini sem acessar a API em produção.
Como instalar client?
Instale o pacote para PHP 8.2 ou superior com o Composer: composer require google-gemini-php/client Instale um cliente HTTP PSR-18 se o seu projeto não tiver um: composer require guzzlehttp/guzzle Crie uma chave de API do Gemini no Google AI Studio Crie o cliente com sua chave de API e chame generateContent em gemini-2.5-flash
Onde consigo client?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/google-gemini-php/client

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados