AIstudioProxyAPI: Unbeschränkte Nutzung der Gemini 2.5 Pro Modell-APIs

Allgemeine Einführung

AIstudioProxyAPI ist ein Open-Source-Projekt, das Node.js und Playwright-Technologie verwendet, um die OpenAI-API zu emulieren, indem es die Google AI Studio webbasiert Zwillinge Modelldialogfunktionalität in eine Standard-API-Schnittstelle. Entwickler können diesen Proxy-Dienst verwenden, um Clients, die die OpenAI-API unterstützen (z. B. Open WebUI, NextChat), direkten Zugriff auf die Google AI-Studio Die unbegrenzte Anzahl von Funktionen. Das Projekt erfordert keine komplexe Konfiguration und ist für Entwickler geeignet, die die Funktionen von Google AI Studio schnell integrieren möchten. Das aktuelle Projekt wird persönlich gepflegt, selten aktualisiert und unterstützt den Headless-Modus nicht, sodass Sie manuell sicherstellen müssen, dass der Chrome-Debugging-Port verfügbar ist.

Funktionsliste

• Angebot /v1/chat/completions im Gesang antworten /v1/models Endpunkte, die mit dem OpenAI-API-Client kompatibel sind.
• Unterstützung von Streaming-Antworten (stream=true), um den Schreibmaschineneffekt zu erzielen.
• Unterstützung für Nicht-Streaming-Antworten (stream=false), die das gesamte JSON auf einmal zurückgibt.
• Optimieren Sie automatisch die Eingabeaufforderungen für die Nutzer und passen Sie das Ausgabeformat von Google AI Studio an.
• Startet automatisch und stellt eine Verbindung zur Chrome-Instanz her, legt den Debug-Port und die Fenstergröße fest.
• Bietet interaktive Optionen zur Behandlung von Portkonflikten oder zur Verbindung mit einer vorhandenen Chrome-Instanz.

Hilfe verwenden

Einbauverfahren

AIstudioProxyAPI ist einfach zu implementieren, aber Sie müssen sicherstellen, dass Ihre Umgebung richtig konfiguriert ist. Nachfolgend finden Sie die detaillierten Schritte:

1. Klon-Lager
   Führen Sie den folgenden Befehl im Terminal aus, um den Projektcode zu erhalten:

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

2. Installation von Abhängigkeiten
   Projekt-Abhängigkeiten express, cors, playwright im Gesang antworten @playwright/test. Wählen Sie je nach Ihrem Paketmanager einen der folgenden Befehle:

   npm install
   # 或
   yarn install
   # 或
   pnpm install
   

   Nachdem die Installation abgeschlossen ist, wird die Abhängigkeit automatisch so konfiguriert, dass@playwright/test Bietet Assertion-Funktionalität.

3. Neue Dienste
   Führen Sie den folgenden Befehl aus, um den Agentendienst zu starten:

   node auto_connect_aistudio.cjs
   

   Das Skript wird:

   • Prüfen Sie, ob die Abhängigkeit vollständig ist.
   • Überprüfen Sie den Debug-Port von Chrome (Standard) 8848), unabhängig davon, ob sie kostenlos ist oder nicht.
   • Einstellen der Größe des Chrome-Fensters (Standardbreite) 460px).
   • Starten Sie automatisch Chrome und öffnen Sie die Seite Google AI Studio.

   Wenn der Port belegt ist, fordert das Skript die Option auf, eine Verbindung zu einer bestehenden Chrome-Instanz herzustellen oder den Port zu löschen und es erneut zu versuchen. Stellen Sie sicher, dass Sie sich manuell auf der Google AI Studio-Seite anmelden, um die Authentifizierung abzuschließen.

Verwendung der Hauptfunktionen

Der Kern von AIstudioProxyAPI besteht darin, die Gemini-Modellfunktionen von Google AI Studio über eine OpenAI API-konforme Schnittstelle für Clients verfügbar zu machen. So funktioniert es:

1. Konfigurieren des Clients
   In Clients, die die OpenAI-API unterstützen (wie Open WebUI), setzen Sie die API-Adresse auf die Adresse des Proxy-Dienstes (Standard) http://localhost:2048). Der Client-Code muss nicht geändert werden, die Schnittstellen sind vollständig kompatibel.
2. Eine Anfrage zum Dialog senden
   Verwenden Sie den Client, um Dialoganfragen im gleichen Format wie die OpenAI-API zu senden. Beispiel:

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

   • aufstellen stream=true Erhalten Sie Streaming-Antworten, die sich für einen Dialog in Echtzeit eignen.
   • aufstellen stream=false Abrufen der vollständigen JSON-Antwort, geeignet für die einmalige Verarbeitung.
3. Aufforderungswörter optimieren
   Der Proxy-Dienst wandelt die Benutzereingaben automatisch um und fügt spezifische Tags (wie <<<START_RESPONSE>>>), um sicherzustellen, dass die Ausgabe von Google AI Studio das erwartete Format hat. Entwickler müssen die Stichwörter nicht manuell anpassen.
4. Verwalten von Chrome-Instanzen
   Nach dem Start muss das Chrome-Fenster geöffnet bleiben und die Google AI Studio-Seite darf nicht abstürzen. Reagiert die Seite nicht, schließen Sie alle zugehörigen Prozesse (node im Gesang antworten chrome), führen Sie erneut die node auto_connect_aistudio.cjs.

Featured Function Bedienung

• Streaming-ReaktionEinstellung auf der Client-Seite stream=trueDie Antwort wird wortwörtlich mit einem Schreibmaschineneffekt angezeigt, der sich für interaktive Anwendungen eignet.
• Handhabung von Hafenkonflikten: Das Skript erkennt 8848 Wenn der Anschluss belegt ist, wird der Benutzer aufgefordert, entweder eine Verbindung zu einer bestehenden Chrome-Instanz herzustellen oder den Anschluss freizugeben.
• Größenänderung von Fenstern: Wenn 460px Breite passt nicht auf den Monitor, kann geändert werden auto_connect_aistudio.cjs den Nagel auf den Kopf treffen --window-size Parameter.

Fehlersuche

• Fehlerhaftes Laden der SeiteÜberprüfen Sie die Netzwerkverbindung und versuchen Sie, manuell darauf zuzugreifen. https://aistudio.google.com/prompts/new_chat und melden Sie sich an.
• Hafenbelegung: Lauf lsof -i :2048 Belegungsprogramme prüfen, schließen oder ändern server.cjs den Nagel auf den Kopf treffen SERVER_PORT.
• Der Dramatiker ist nicht bereit.Vergewissern Sie sich, dass das Chrome-Fenster nicht geschlossen ist, und führen Sie das Startskript erneut aus.

Anwendungsszenario

1. Schnelle Integration von KI-Dialogfunktionen
   Entwickler möchten ihren Anwendungen KI-Dialogfunktionen hinzufügen, sind aber durch die OpenAI-API-Quote eingeschränkt. Mit aIstudioProxyAPI können Entwickler das kostenlose Kontingent von Google AI Studio nutzen, um Funktionen schnell über die vertraute OpenAI-API-Schnittstelle zu implementieren.
2. Lokale Entwicklung und Prüfung
   Entwicklungsteams können die OpenAI-API über AIstudioProxyAPI emulieren, wenn sie KI-Dialogfunktionen in ihren lokalen Umgebungen testen, wodurch der Erwerb zusätzlicher API-Kontingente entfällt und die Kosten gesenkt werden.
3. Bildung und Forschung
   Studenten oder Forscher müssen mit großen Modelldialogfunktionen experimentieren, haben aber keinen API-Zugang. AIstudioProxyAPI bietet einfachen Zugang zu Gemini-Modellen für die akademische Forschung.

QA

1. Welche Clients werden von AIstudioProxyAPI unterstützt?
   Jeder Client, der die OpenAI-API unterstützt (z. B. Open WebUI, NextChat), kann ohne Änderung des Client-Codes verwendet werden.
2. Warum wird der Headless-Modus nicht unterstützt?
   Die automatische Erkennung von Google AI Studio schränkt den Headless-Modus auf eine verknüpfte Chrome-Instanz ein.
3. Wie geht man mit besetzten Häfen um?
   Sonde 2048 vielleicht 8848 Hafenbelegung, Schließung kollidierender Programme oder Änderung server.cjs Die Anschlusskonfiguration in der
4. Erfordert der Dienst eine ständige Vernetzung?
   Ja, der Proxy-Dienst erfordert einen Internetzugang zur Google AI Studio-Seite, um sicherzustellen, dass die Seite korrekt geladen wird.