Allgemeine Einführung
genspark2api ist ein Open-Source-API-Service-Tool, das auf GitHub gehostet und vom Entwickler deanxv erstellt wurde. Es bietet einen Schnittstellendienst, der Dialoge mit mehreren Modellen, Text-zu-Grafik und Text-zu-Video unterstützt, die Benutzer schnell lokal oder auf Servern über Docker bereitstellen können. Die Kernfunktion dieses Tools ist es, Entwicklern den einfachen Aufruf mehrerer Dialogmodelle (z.B. gpt-4o, claude-3-5-sonnet) und Generierungswerkzeuge (z.B. flux, dall-e-3) zu ermöglichen und mehrere Dialogrunden wie vernetzte Suche und Bilderkennung zu unterstützen. Die Projektversion ist derzeit 3.4, und der Code ist für die Benutzer völlig offen und kann frei verändert werden. Es soll den Entwicklungsprozess vereinfachen und eignet sich für Technikbegeisterte oder kleine Teams.
Funktionsliste
- Es werden mehrere Dialogmodell-Schnittstellen (Streaming und Non-Streaming) unterstützt, wie z. B.
gpt-4o
undclaude-3-5-sonnet
Wenn das Modell nicht unterstützt wird, schaltet es automatisch in den Modus Mixture-of-Agents um. - Bieten Sie eine Netzwerk-Suchfunktion an, indem Sie den Modellnamen nach der
-search
verwendet werden, zum Beispielgpt-4o-search
. - Multirunden-Dialog mit Unterstützung für Bild- und Dateierkennung, bei dem die Benutzer Inhalte hochladen können, um mit ihnen zu interagieren.
- eine Schnittstelle zum Entlüften bieten
/images/generations
Die Fördermodelle sind wie folgtflux
unddall-e-3
. - Unterstützt sowohl Text-zu-Elektronik- als auch Grafik-zu-Elektronik-Video-Schnittstellen
/videos/generations
Zu den verfügbaren Modellen gehörenkling/v1.6/standard
. - Verbessern Sie die Dienststabilität mit Cookie-Pooling und automatischer Wiederholung.
- Unterstützung für benutzerdefinierte Schnittstellentasten (
API_SECRET
) und die Agentenkonfiguration (PROXY_URL
). - Ermöglichen Sie die Bindung von Modellen und Dialogen, um zu verhindern, dass ein Modellwechsel die Antwortqualität beeinträchtigt.
Hilfe verwenden
Einbauverfahren
genspark2api basiert auf dem Docker Deployment und ist für Benutzer mit grundlegenden technischen Kenntnissen geeignet. Hier sind die detaillierten Schritte:
- Installation von Docker
Installieren Sie Docker auf Ihrem Computer oder Server. rufen Sie diehttps://www.docker.com/
Herunterladen und installieren. Führen Sie nach der Installation den folgenden Befehl zur Bestätigung aus:
docker --version
Wenn die Versionsnummer angezeigt wird, ist die Umgebung bereit.
- Spiegel abziehen
Geben Sie den Befehl in das Terminal ein, um das neueste Image zu laden:
docker pull deanxv/genspark2api:latest
Wenn der Pull-Vorgang fehlschlägt, verwenden Sie einen GitHub-Spiegel:
docker pull ghcr.io/deanxv/genspark2api:latest
- Umgebungsvariablen konfigurieren
Erstellen Sie einen lokalen Ordner (z. B../data
), um die Daten zu speichern. Bereiten Sie die folgenden Variablen vor:
GS_COOKIE
: Von genspark Cookies, die von der offiziellen Website stammen, mehrere durch Komma getrennt.API_SECRET
Ein benutzerdefinierter Schlüssel, z. B. "123456", wird für die Sicherheitsüberprüfung der Schnittstelle verwendet.TZ
Zeitzone, z. B. "Asien/Shanghai".
Beispiel Ausführungsbefehl:
docker run --name genspark2api -d --restart always
-p 7055:7055
-v ./data:/app/genspark2api/data
-e GS_COOKIE="session_id=你的cookie"
-e API_SECRET="123456"
-e TZ="Asia/Shanghai"
deanxv/genspark2api:latest
- Starten und Überprüfen
Rufen Sie nach der Ausführung diehttp://localhost:7055
Überprüfen Sie den Status des Dienstes. Wenn Sie die Protokolle überprüfen müssen:
docker logs genspark2api
Einen Keks bekommen
- Öffnen Sie Ihren Browser und drücken Sie F12, um die Entwicklertools aufzurufen.
- Interviews
https://www.genspark.ai
, um einen Dialog einzuleiten. - Auf der Registerkarte Netzwerk finden Sie die
ask
Anfrage, kopieren Sie die Kopfzeile der Anfrage in die Dateicookie
Wert.
muss enthaltensession_id=xxx
Die anderen Teile sind fakultativ.
Verwendung der Dialogschnittstelle
Der Pfad der Dialogschnittstelle lautet /chat/completions
unterstützt sowohl Streaming- als auch Non-Streaming-Ausgaben.
- Beispiel für einen Antrag(Nicht-Streaming):
curl -X POST http://localhost:7055/chat/completions
-H "Authorization: Bearer 123456"
-H "Content-Type: application/json"
-d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "你好"}]}'
- Streaming-Ausgang: Hinzufügen
"stream": true
Die Daten werden in Chunks zurückgegeben. - Zurück zum Beispiel::
{"choices": [{"message": {"role": "assistant", "content": "你好!有什么可以帮助你的吗?"}}]}
Verwendung der Vincennes-Schnittstelle
Der Pfad ist /images/generations
Unterstützung für die Erstellung von Bildern.
- Beispiel für einen Antrag::
curl -X POST http://localhost:7055/images/generations
-H "Authorization: Bearer 123456"
-H "Content-Type: application/json"
-d '{"model": "flux", "prompt": "一只猫在草地上玩耍"}'
- Zurück zum Beispiel::
{"data": [{"url": "https://example.com/image.jpg"}]}
Verwendung der Vincent Video-Schnittstelle
Der Pfad ist /videos/generations
unterstützen Text oder Bild zur Erstellung von Videos.
- Beispiel für einen Antrag(Textgenerierung):
curl -X POST http://localhost:7055/videos/generations
-H "Authorization: Bearer 123456"
-H "Content-Type: application/json"
-d '{"model": "kling/v1.6/standard", "prompt": "城市夜景", "aspect_ratio": "16:9", "duration": 10, "auto_prompt": true}'
- Zurück zum Beispiel::
{"created": 1677664796, "data": [{"url": "https://example.com/video.mp4"}]}
Konfigurieren der ReCaptcha-Authentifizierung
Die Verifizierung durch ReCaptchaV3 ist offiziell vorgeschrieben, andernfalls kann das Modell an Intelligenz verlieren oder Anomalien erzeugen. Sie ist erforderlich für die Arbeit mit genspark-playwright-proxy
Dienstleistungen:
- Bereitstellung von Proxy-Diensten:
docker run --name genspark-playwright-proxy -d --restart always
-p 7022:7022
-v ./data:/app/genspark-playwright-proxy/data
-e TZ="Asia/Shanghai"
deanxv/genspark-playwright-proxy:latest
- Fügen Sie Umgebungsvariablen zu genspark2api hinzu:
-e RECAPTCHA_PROXY_URL="http://127.0.0.1:7022"
- Starten Sie den Dienst neu, damit er wirksam wird.
Häufig gestellte Fragen
- Schnittstelle gibt "Alle Cookies sind vorübergehend nicht verfügbar" zurück.
Alle Cookies haben das Ratenlimit erreicht. Ersetzen Sie durch ein neuesGS_COOKIE
Oder warten Sie eine Weile. - Begegnungen mit Cloudflare-Abschnitten
konfigurieren.PROXY_URL
z.B..-e PROXY_URL="http://127.0.0.1:10801"
.
Anwendungsszenario
- Entwicklung eines intelligenten Kundendienstes
Schnelles Erstellen von Kundenservice-Bots durch Dialogschnittstellen, die vernetzte Suchen und mehrere Dialogrunden zur Beantwortung von Kundenfragen unterstützen. - Kreative Inhalte generieren
Mit den Funktionen Text-zu-Grafik und Text-zu-Video können Sie Beschreibungen eingeben, um Bilder oder kurze Videos für die Verwendung in Design-Prototypen oder Inhalten für soziale Medien zu erstellen. - Bildung und technologisches Lernen
Studenten oder Entwickler können Dienste bereitstellen, verschiedene Modelle für Experimente aufrufen und etwas über APIs und Modellintegration lernen.
QA
- Welche Dialogmodelle werden unterstützt?
etw. unterstützengpt-4o
undclaude-3-5-sonnet
Es gibt eine Vielzahl von Modellen, wie z. B. das Mixture-of-Agents-Modell, und nicht aufgeführte Modelle lösen den Mixture-of-Agents-Modus aus. - Was ist, wenn die vinzentinische Karte scheitert?
SondeRECAPTCHA_PROXY_URL
Ist sie richtig konfiguriert, um sicherzustellen, dass sie die ReCaptchaV3-Validierung besteht. - Wie lässt sich die Stabilität der Dienste verbessern?
Konfigurieren Sie mehrereGS_COOKIE
Wenn Sie das Cookie-Pooling aktivieren möchten, können Sie automatisch umschalten, wenn eine Anfrage fehlschlägt.