AIstudioProxyAPI : Utilisation illimitée des API du modèle Gemini 2.5 Pro

Introduction générale

AIstudioProxyAPI est un projet open source qui utilise Node.js et la technologie Playwright pour émuler l'API OpenAI en simulant l'interface utilisateur. Google AI Studio en ligne Gémeaux dans une interface API standard. Les développeurs peuvent utiliser ce service proxy pour donner aux clients qui supportent l'API OpenAI (par exemple Open WebUI, NextChat) un accès direct à l'API Google AI Studio Le nombre de fonctionnalités est illimité. Le projet ne nécessite pas de configuration complexe et convient aux développeurs qui souhaitent intégrer rapidement les fonctionnalités de Google AI Studio. Le projet actuel est entretenu personnellement, n'est pas mis à jour fréquemment et ne prend pas en charge le mode headless. Vous devez donc vous assurer manuellement que le port de débogage Chrome est disponible.

Liste des fonctions

• offrir /v1/chat/completions répondre en chantant /v1/models compatibles avec le client de l'API OpenAI.
• Prise en charge de la réponse en continu (stream=true) pour obtenir l'effet machine à écrire.
• Prise en charge des réponses non continues (stream=false), qui renvoie le JSON complet en une seule fois.
• Optimiser automatiquement les invites de saisie de l'utilisateur et adapter le format de sortie de Google AI Studio.
• Démarre et se connecte automatiquement à l'instance de Chrome, définit le port de débogage et la taille de la fenêtre.
• Fournit des options interactives pour gérer les conflits de port ou se connecter à une instance Chrome existante.

Utiliser l'aide

Processus d'installation

AIstudioProxyAPI est simple à déployer, mais vous devez vous assurer que votre environnement est correctement configuré. Vous trouverez ci-dessous les étapes détaillées :

1. entrepôt de clones
   Exécutez la commande suivante dans le terminal pour obtenir le code du projet :

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

2. Installation des dépendances
   Dépendances du projet express, cors, playwright répondre en chantant @playwright/test. Choisissez l'une des commandes suivantes en fonction de votre gestionnaire de paquets :

   npm install
   # 或
   yarn install
   # 或
   pnpm install
   

   Une fois l'installation terminée, la dépendance est automatiquement configurée comme suit@playwright/test Fournit une fonctionnalité d'assertion.

3. Démarrage des services
   Exécutez la commande suivante pour démarrer le service de l'agent :

   node auto_connect_aistudio.cjs
   

   Le texte sera :

   • Vérifier que la dépendance est complète.
   • Vérifier le port de débogage de Chrome (par défaut) 8848), qu'il soit gratuit ou non.
   • Définition de la taille de la fenêtre de Chrome (largeur par défaut) 460px).
   • Lancez automatiquement Chrome et ouvrez la page Google AI Studio.

   Si le port est occupé, le script propose de se connecter à une instance Chrome existante ou d'effacer le port et de réessayer. Veillez à vous connecter manuellement à la page Google AI Studio pour terminer l'authentification.

Utilisation des fonctions principales

L'objectif principal d'AIstudioProxyAPI est de mettre les capacités du modèle Gemini de Google AI Studio à la disposition des clients par le biais d'une interface conforme à l'API OpenAI. Voici comment cela fonctionne :

1. Configuration du client
   Dans les clients qui prennent en charge l'API OpenAI (comme Open WebUI), l'adresse de l'API doit être l'adresse du service proxy (par défaut). http://localhost:2048). Il n'est pas nécessaire de modifier le code du client, les interfaces sont entièrement compatibles.
2. Envoyer une demande de dialogue
   Utilisez le client pour envoyer des demandes de dialogue dans le même format que l'API OpenAI. Exemple :

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

   • mettre en place stream=true Obtenez des réponses en continu, adaptées au dialogue en temps réel.
   • mettre en place stream=false Obtenir la réponse JSON complète, adaptée à un traitement unique.
3. Optimiser les mots-clés
   Le service proxy enveloppe automatiquement les données saisies par l'utilisateur, en ajoutant des balises spécifiques (telles que <<<START_RESPONSE>>>) pour s'assurer que les résultats de Google AI Studio sont dans le format attendu. Les développeurs n'ont pas besoin d'ajuster manuellement les mots-clés.
4. Gestion des instances de Chrome
   Après le lancement, la fenêtre Chrome doit rester ouverte et la page Google AI Studio ne doit pas se bloquer. Si la page ne répond pas, fermez tous les processus associés (node répondre en chantant chrome), réexécutez le node auto_connect_aistudio.cjs.

Fonction en vedette Fonctionnement

• réponse en continu: Paramétrage du côté du client stream=trueLa réponse est affichée textuellement avec un effet de machine à écrire, ce qui convient aux applications interactives.
• Gestion des conflits de portsLe script détecte 8848 Lorsque le port est occupé, l'utilisateur est invité à choisir entre se connecter à une instance Chrome existante ou libérer le port.
• Redimensionnement des fenêtres: Si 460px La largeur n'est pas adaptée au moniteur, elle peut être modifiée auto_connect_aistudio.cjs a fait mouche --window-size Paramètres.

Dépannage

• Échec du chargement de la pageLa connexion au réseau : Vérifiez la connexion au réseau et essayez d'y accéder manuellement. https://aistudio.google.com/prompts/new_chat et se connecter.
• occupation du port: Run lsof -i :2048 Vérifier les programmes d'occupation, les fermer ou les modifier server.cjs a fait mouche SERVER_PORT.
• Le dramaturge n'est pas prêt.La fenêtre de Chrome ne doit pas être fermée et le script de démarrage doit être réexécuté.

scénario d'application

1. Intégration rapide des fonctions de dialogue de l'IA
   Les développeurs souhaitent ajouter des fonctionnalités de dialogue IA à leurs applications, mais sont limités par le quota de l'API OpenAI. aIstudioProxyAPI permet aux développeurs de profiter du quota gratuit de Google AI Studio pour mettre rapidement en œuvre des fonctionnalités par le biais de l'interface API OpenAI qui leur est familière.
2. Développement et essais locaux
   Les équipes de développement peuvent émuler l'API OpenAI grâce à AIstudioProxyAPI lorsqu'elles testent les fonctionnalités du dialogue d'IA dans leurs environnements locaux, ce qui évite d'avoir à acheter des quotas d'API supplémentaires et réduit les coûts.
3. Éducation et recherche
   Les étudiants ou les chercheurs ont besoin d'expérimenter les fonctions de dialogue des grands modèles mais n'ont pas accès à l'API. AIstudioProxyAPI offre un accès facile aux modèles Gemini pour la recherche universitaire.

QA

1. Quels sont les clients pris en charge par AIstudioProxyAPI ?
   Tout client qui prend en charge l'API OpenAI (par exemple Open WebUI, NextChat) peut être utilisé sans modifier le code du client.
2. Pourquoi le mode sans tête n'est-il pas pris en charge ?
   La détection automatisée de Google AI Studio limite le mode sans tête à une instance Chrome interfacée.
3. Comment traiter les ports occupés ?
   sonde 2048 peut-être 8848 l'occupation des ports, de clore les programmes conflictuels ou de modifier server.cjs La configuration du port dans le
4. Le service nécessite-t-il une mise en réseau permanente ?
   Oui, le service proxy nécessite un accès Internet à la page Google AI Studio pour garantir un chargement correct de la page.