Repolode
google-gemini-php

google-gemini-php/client

Cliente PHP mantenido por la comunidad para Gemini API, con funciones de texto, contenido multimedia, streaming, herramientas y gestión de archivos y caché.

Estrellas
412
Forks
83
Issues abiertos
2
Último commit
hace 26 días

¿Qué es?

Gemini PHP es un cliente de API para PHP, mantenido por la comunidad, para Gemini API de Google. Permite que las aplicaciones PHP envíen texto e imágenes, videos, audio y documentos a los modelos Gemini, y admite streaming, conversaciones de varios turnos, respuestas JSON estructuradas y llamadas a funciones.

El cliente también integra herramientas incluidas, como Google Search, Google Maps, URL context, File Search y ejecución de código, además de generación de imágenes y voz y configuración de modelos de razonamiento. Ofrece métodos específicos para gestionar archivos, caché de contexto, almacenes de File Search, embeddings y listados de modelos.

Requiere PHP 8.2 o posterior, se instala mediante Composer e incluye un cliente simulado para escribir pruebas sin llamar a la API en producción.

Funciones clave

  • 01Admite entradas de texto, imágenes, videos, audio y documentos.
  • 02Ofrece respuestas en streaming y sesiones de chat de varios turnos.
  • 03Genera respuestas JSON estructuradas mediante esquemas o matrices de JSON Schema.
  • 04Incluye llamadas a funciones y herramientas integradas, como Google Search y ejecución de código.
  • 05Permite subir archivos y ofrece caché de contexto y almacenes de File Search.
  • 06Incluye un cliente simulado para realizar pruebas.

Casos de uso

  • Añadir chat o generación de contenido con Gemini a un backend de Laravel u otro framework PHP.
  • Extraer datos estructurados de documentos o imágenes y convertirlos en JSON tipado.
  • Crear respuestas con generación aumentada por recuperación sobre documentos subidos mediante File Search.
  • Escribir pruebas unitarias para código PHP que llama a Gemini sin acceder a la API en producción.

Inicio rápido

  1. 1

    Instala el paquete para PHP 8.2 o superior con Composer

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

    Instala un cliente HTTP PSR-18 si tu proyecto no tiene uno

    composer require guzzlehttp/guzzle
  3. 3

    Crea una clave de API de Gemini en Google AI Studio

  4. 4

    Crea el cliente con tu clave de API y llama a generateContent en gemini-2.5-flash

Antes de usarlo

  • Se requiere PHP 8.2 o una versión posterior.
  • Se requiere una clave de API de Gemini de Google AI Studio.
  • La versión 2.0 solo funciona con la API Gemini v1beta.

Temas

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

Preguntas frecuentes

¿Qué es client?
Cliente PHP mantenido por la comunidad para Gemini API, con funciones de texto, contenido multimedia, streaming, herramientas y gestión de archivos y caché. Gemini PHP es un cliente de API para PHP, mantenido por la comunidad, para Gemini API de Google. Permite que las aplicaciones PHP envíen texto e imágenes, videos, audio y documentos a los modelos Gemini, y admite streaming, conversaciones de varios turnos, respuestas JSON estructuradas y llamadas a funciones.
¿client es gratuito? ¿Qué licencia tiene?
client es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿client sigue mantenido?
Mantenimiento activo. El último commit de client fue el 12 oct 2026.
¿Para qué puedo usar client?
Añadir chat o generación de contenido con Gemini a un backend de Laravel u otro framework PHP. Extraer datos estructurados de documentos o imágenes y convertirlos en JSON tipado. Crear respuestas con generación aumentada por recuperación sobre documentos subidos mediante File Search. Escribir pruebas unitarias para código PHP que llama a Gemini sin acceder a la API en producción.
¿Cómo se instala client?
Instala el paquete para PHP 8.2 o superior con Composer: composer require google-gemini-php/client Instala un cliente HTTP PSR-18 si tu proyecto no tiene uno: composer require guzzlehttp/guzzle Crea una clave de API de Gemini en Google AI Studio Crea el cliente con tu clave de API y llama a generateContent en gemini-2.5-flash
¿Dónde consigo client?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/google-gemini-php/client

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados