AIstudioProxyAPI: uso ilimitado de las API del modelo Gemini 2.5 Pro

Introducción general

AIstudioProxyAPI es un proyecto de código abierto que utiliza Node.js y la tecnología Playwright para emular la API OpenAI mediante la simulación de la Google AI Studio a través de Internet Géminis en una interfaz API estándar. Los desarrolladores pueden utilizar este servicio proxy para proporcionar a los clientes compatibles con la API OpenAI (por ejemplo, Open WebUI, NextChat) acceso directo a la API de diálogo de Google. Estudio AI La cantidad ilimitada de características. El proyecto no requiere una configuración compleja y es adecuado para los desarrolladores que deseen integrar rápidamente las capacidades de Google AI Studio. El proyecto actual se mantiene personalmente, se actualiza con poca frecuencia y no admite el modo headless, por lo que es necesario asegurarse manualmente de que el puerto de depuración de Chrome está disponible.

Lista de funciones

• oferta /v1/chat/completions responder cantando /v1/models compatibles con el cliente de la API OpenAI.
• Soporte de respuesta de streaming (stream=true) para conseguir el efecto máquina de escribir.
• Compatibilidad con respuestas no fluidas (stream=false), que devuelve el JSON completo de una vez.
• Optimiza automáticamente las solicitudes de entrada del usuario y adapta el formato de salida de Google AI Studio.
• Inicia y se conecta automáticamente a la instancia de Chrome, establece el puerto de depuración y el tamaño de la ventana.
• Proporciona opciones interactivas para gestionar conflictos de puertos o conectarse a una instancia de Chrome existente.

Utilizar la ayuda

Proceso de instalación

AIstudioProxyAPI es fácil de desplegar, pero debe asegurarse de que su entorno está correctamente configurado. A continuación se detallan los pasos a seguir:

1. almacén de clones
   Ejecute el siguiente comando en el terminal para obtener el código del proyecto:

   git clone https://github.com/CJackHwang/AIstudioProxyAPI
   cd AIstudioProxyAPI

2. Instalación de dependencias
   Dependencias del proyecto express, cors, playwright responder cantando @playwright/test. Elija uno de los siguientes comandos en función de su gestor de paquetes:

   npm install
   # 或
   yarn install
   # 或
   pnpm install
   

   Una vez finalizada la instalación, se configura automáticamente la dependencia que@playwright/test Proporciona funcionalidad de aserción.

3. Inicio de los servicios
   Ejecute el siguiente comando para iniciar el servicio de agente:

   node auto_connect_aistudio.cjs
   

   El guión lo hará:

   • Comprueba que la dependencia está completa.
   • Verificar el puerto de depuración de Chrome (por defecto) 8848) tanto si es gratuito como si no.
   • Establecer el tamaño de la ventana de Chrome (anchura por defecto) 460px).
   • Inicie automáticamente Chrome y abra la página de Google AI Studio.

   Si el puerto está ocupado, el script solicita la opción de conectarse a una instancia de Chrome existente o borrar el puerto y volver a intentarlo. Asegúrate de iniciar sesión manualmente en la página de Google AI Studio para completar la autenticación.

Utilización de las funciones principales

El objetivo de AIstudioProxyAPI es poner a disposición de los clientes las capacidades del modelo Gemini de Google AI Studio a través de una interfaz compatible con la API OpenAI. Así es como funciona:

1. Configurar el cliente
   En clientes que soportan la API OpenAI (como Open WebUI), establece la dirección API a la dirección del servicio proxy (por defecto) http://localhost:2048). No es necesario cambiar el código del cliente, las interfaces son totalmente compatibles.
2. Enviar una solicitud de diálogo
   Utilice el cliente para enviar solicitudes de diálogo en el mismo formato que la API OpenAI. Ejemplo:

   {
   "model": "gemini",
   "messages": [
   {"role": "system", "content": "你是一个助手"},
   {"role": "user", "content": "请解释量子力学"}
   ],
   "stream": true
   }
   

   • establecer stream=true Obtenga respuestas en streaming, adecuadas para el diálogo en tiempo real.
   • establecer stream=false Obtener la respuesta JSON completa, adecuada para un procesamiento único.
3. Optimizar las palabras clave
   El servicio proxy envuelve automáticamente la entrada del usuario, añadiendo etiquetas específicas (como <<<START_RESPONSE>>>) para garantizar que la salida de Google AI Studio tenga el formato esperado. Los desarrolladores no necesitan ajustar manualmente las palabras clave.
4. Gestión de instancias de Chrome
   Tras el inicio, la ventana de Chrome debe permanecer abierta y la página de Google AI Studio no debe bloquearse. Si la página no responde, cierra todos los procesos relacionados (node responder cantando chrome), vuelva a ejecutar el node auto_connect_aistudio.cjs.

Función destacada Operación

• respuesta en tiempo realAjuste en el lado del cliente stream=trueLa respuesta se muestra textualmente con un efecto de máquina de escribir, adecuado para aplicaciones interactivas.
• Gestión de conflictos portuariosEl script detecta 8848 Cuando el puerto está ocupado, se pide al usuario que elija entre conectarse a una instancia de Chrome existente o borrar el puerto.
• Redimensionamiento de ventanasSi 460px La anchura no se ajusta al monitor, se puede modificar auto_connect_aistudio.cjs ha dado en el clavo --window-size Parámetros.

Solución de problemas

• Fallo de carga de la páginaCompruebe la conexión de red e intente acceder manualmente. https://aistudio.google.com/prompts/new_chat e inicia sesión.
• ocupación portuaria: Ejecutar lsof -i :2048 Comprobar programas de ocupación, cerrar o cambiar server.cjs ha dado en el clavo SERVER_PORT.
• El dramaturgo no está preparado.Asegúrate de que la ventana de Chrome no está cerrada y vuelve a ejecutar el script de inicio.

escenario de aplicación

1. Rápida integración de las funciones de diálogo de la IA
   aIstudioProxyAPI permite a los desarrolladores aprovechar la cuota gratuita de Google AI Studio para implementar rápidamente funciones a través de la conocida interfaz API OpenAI.
2. Desarrollo y pruebas locales
   Los equipos de desarrollo pueden emular la API OpenAI a través de AIstudioProxyAPI cuando prueben la funcionalidad de diálogo de IA en sus entornos locales, lo que elimina la necesidad de adquirir cuotas de API adicionales y reduce los costes.
3. Educación e investigación
   Los estudiantes o investigadores necesitan experimentar con grandes funciones de diálogo de modelos pero carecen de acceso a la API.AIstudioProxyAPI proporciona un acceso sencillo a los modelos Gemini para la investigación académica.

CONTROL DE CALIDAD

1. ¿Qué clientes admite AIstudioProxyAPI?
   Cualquier cliente compatible con la API OpenAI (por ejemplo, Open WebUI, NextChat) se puede utilizar sin modificar el código del cliente.
2. ¿Por qué no se admite el modo sin cabeza?
   La detección automática de Google AI Studio restringe el modo sin cabeza a una instancia de Chrome interconectada.
3. ¿Cómo tratar los puertos ocupados?
   sonda 2048 tal vez 8848 ocupación portuaria, cerrar programas conflictivos o modificar server.cjs La configuración del puerto en el
4. ¿Requiere el servicio una conexión en red continua?
   Sí, el servicio proxy requiere acceso a Internet a la página de Google AI Studio para garantizar que la página se carga correctamente.