grok2api: Konvertierung von Grok in eine freie API für Chat und Bilderzeugung

grok2api ist ein Open-Source-Projekt, das auf einem Refactoring des FastAPI-Frameworks basiert und darauf abzielt, X (ehemals Twitter) Grok Das Webaufrufformat für große Modelle wird in eine Schnittstelle umgewandelt, die vollständig mit der OpenAI API kompatibel ist. Dies ermöglicht es Entwicklern, die leistungsstarken Funktionen von Grok problemlos in eine Vielzahl von bestehenden Anwendungen und Diensten zu integrieren. Das Projekt unterstützt nicht nur Streaming-Dialoge, vernetzte Suche und Deep-Thinking-Modi, sondern implementiert auch Multimedia-Funktionen wie Bilderzeugung, Bildbearbeitung und Videoerzeugung. Um mehrere Grok-Konten effektiv zu verwalten, verfügt grok2api über einen eingebauten Account-Pooling-Mechanismus für gleichzeitige Anrufe und einen automatischen Lastausgleichsmechanismus, der die Anzahl der Anrufe für jedes Konto in Echtzeit überwachen und zuweisen kann, wodurch die Nutzung der Ressourcen maximiert wird. Das Projekt bietet auch ein visuelles Management-Backend für Benutzer, um Parameter zu konfigurieren, Konten zu verwalten und den Dienststatus zu überwachen.

Funktionsliste

• Kompatibel mit OpenAI-SchnittstelleDie vom Projekt zur Verfügung gestellten API-Endpunkte sind vollständig kompatibel mit der offiziellen OpenAI-Schnittstelle, was die Migration und Integration für Entwickler erleichtert.
• Multimedia-Verarbeitung:: Unterstützung für die Erstellung von Bildern direkt im Dialog oder von Videos auf der Grundlage von Bildern und Aufforderungsworten durch ein bestimmtes Modell.
• Unterstützung mehrerer Modelle: Unterstützung grok-3-fast, grok-4-fast, grok-4-expert usw. Die Benutzer können je nach ihren Bedürfnissen verschiedene Modelle wählen, die sie anrufen können.
• Kontopooling und LastausgleichUnterstützt das stapelweise Hinzufügen von Grok-Konten. Das System gleicht die Anzahl der Anrufe an alle Konten automatisch aus, um zu vermeiden, dass ein einzelnes Konto aufgrund von Überlastung eingeschränkt wird.
• strukturierter DialogStreaming Response wird unterstützt, so dass Sie Inhalte wortwörtlich wie auf einer offiziellen Website ausgeben können, was das interaktive Erlebnis noch verbessert.
• Caching-MechanismusDas System zwischenspeichert die generierten Bild- und Videodateien automatisch lokal, um das Problem zu lösen, dass der offizielle Grok-Link nicht direkt aufgerufen werden kann, und durch die Konfiguration desBase Urlum sicherzustellen, dass die Mediendateien richtig angezeigt werden. [cite:1-2]
• Visuelles Management Back OfficeBietet eine Web-Verwaltungsschnittstelle, über die sich Benutzer am Backend anmelden können, um das System zu konfigurieren, Kontotoken zu verwalten, Nutzungsstatistiken anzuzeigen und den Cache zu löschen.
• Flexible SpeicheroptionenUnterstützung der Verwendung von lokalen Dateien, MySQL-Datenbanken oder Redis als Speicher-Backend für Konto- und Konfigurationsinformationen, die sich an verschiedene Einsatzumgebungen anpassen lassen.

Hilfe verwenden

grok2api bietet eine Vielzahl von Möglichkeiten zur Bereitstellung und Nutzung, wobei Docker Compose die einfachste und schnellste Möglichkeit ist.

1. die Methodik des Einsatzes

Empfohlen docker-compose Führen Sie Ein-Klick-Bereitstellungen durch, die die Komplexität der Umgebungskonfiguration vereinfachen können.

Erstellen Sie zunächst eine Datei namens docker-compose.yml und kopieren Sie den folgenden Text in diese Datei:

services:
grok2api:
image: ghcr.io/chenyme/grok2api:latest
container_name: grok2api
ports:
- "8000:8000"
volumes:
- grok_data:/app/data
- ./logs:/app/logs
environment:
# 存储模式，可选值为 file, mysql 或 redis，默认为 file
- STORAGE_MODE=file
# 如果使用 mysql 或 redis，需要配置下面的数据库连接URL
# - DATABASE_URL=mysql://user:password@host:3306/grok2api
volumes:
grok_data:

Öffnen Sie dann in dem Verzeichnis, in dem sich die Datei befindet, ein Terminal und führen Sie den folgenden Befehl aus, um den Dienst zu starten:

docker-compose up -d

Der Dienst wird im Hintergrund gestartet und wartet auf lokale 8000 Häfen.

2. die Initialisierungskonfiguration

Nachdem der Dienst zum ersten Mal gestartet wurde, müssen Sie eine erste Konfiguration über das Verwaltungs-Backend vornehmen.

1. Zugang zum Hintergrund der Verwaltung
   In Ihrem Browser öffnen http://<你的服务器地址>:8000/login.
   Der Standard-Benutzername des Administrators lautet adminDas Kennwort lautet admin.
2. Administratorkennwort ändern
   Nach der Anmeldung ändern Sie bitte den Standard-Administrator-Benutzernamen und das Passwort auf der Seite "Systemkonfiguration" des Verwaltungshintergrunds, um die Sicherheit des Dienstes zu gewährleisten.
3. Konfigurieren der Basis-URL
   Dies ist ein sehr wichtiger Schritt, vor allem, wenn Sie die Funktion zur Erstellung von Bildern oder Videos verwenden möchten.base_url ist erforderlich, damit auf die erzeugten Mediendateien ordnungsgemäß zugegriffen werden kann. Bitte setzen Sie sie auf eine Adresse, auf die Ihr Server zugreifen kann, z. B. http://192.168.1.10:8000 vielleicht https://your-domain.com.
4. Grok-Konto hinzufügen
   Klicken Sie auf der Seite "Token Management" im Administrationshintergrund auf die Schaltfläche "Add Token in Bulk" und fügen Sie Ihre Grok-Kontoinformationen hinzu (z. B. Ihr Token, Token, Token, Token, Token, Token, Token, Token, Token, Token).cf_clearance im Gesang antworten auth_token) eingefügt. Diese Informationen muss der Benutzer über die Entwicklerwerkzeuge des Browsers abrufen.

3. wie man die API aufruft

grok2api hat Schnittstellen zu OpenAIs chat/completions Die Schnittstellen sind vollständig kompatibel. Sie können sie mit jedem Client oder jeder Bibliothek aufrufen, die die OpenAI-API unterstützt.

Eine Chat-Anfrage initiieren

Im Folgenden wird ein Beispiel für die Verwendung der curl Beispiel für einen Befehl zum Starten einer Streaming-Chat-Anfrage:

curl https://你的服务器地址/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <你在后台设置的API_KEY>" \
-d '{
"model": "grok-4-fast",
"messages": [
{
"role": "user",
"content": "你好，请介绍一下你自己"
}
],
"stream": true
}'

• Oberbefehlshaber (Militär) 你的服务器地址 Ersetzen Sie durch die IP-Adresse oder den Domänennamen, unter dem der grok2api-Dienst bereitgestellt wird.
• Oberbefehlshaber (Militär) <你在后台设置的API_KEY> Ersetzen Sie sie durch diejenige, die Sie im Admin-Backend eingestellt haben api_key. Falls nicht eingestellt, ist es nicht erforderlich Authorization Kopfzeile der Anfrage.

Bild generieren

Fügen Sie den Befehl "Draw one" oder einen ähnlichen Befehl in den Dialog ein, um die Bilderzeugungsfunktion auszulösen.

curl https://你的服务器地址/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <你在后台设置的API_KEY>" \
-d '{
"model": "grok-4-fast",
"messages": [
{
"role": "user",
"content": "请帮我画一只正在写代码的猫"
}
]
}'

Das System gibt zwei Bilder im Markdown-Format zurück und verbraucht vier Credits. Die zurückgegebenen Bildlinks basieren auf den von Ihnen konfigurierten base_url.

Video generieren

Um das Video zu erstellen, müssen Sie Folgendes auswählen grok-imagine-0.9 Modell und geben ein Bild und ein entsprechendes Stichwort ein.

curl https://你的服务器地址/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <你在后台设置的API_KEY>" \
-d '{
"model": "grok-imagine-0.9",
"messages": [
{
"role": "user",
"content": [
{
"type": "text",
"text": "让画面中的风车转动起来"
},
{
"type": "image_url",
"image_url": {
"url": "https://your-image-url.jpg"
}
}
]
}
]
}'

Die Rückgabe ist ein HTML-Code, der einen Link zum Video enthält <video> Tags.

Anwendungsszenario

1. Erweiterung der Anwendung
   Für alle Arten von Anwendungen, die bereits die OpenAI-API integriert haben (z. B. Chatbots, Tools zur Erstellung von Inhalten usw.), können Entwickler grok2api verwenden, um die Fähigkeiten der Grok-Modelle schnell und praktisch ohne Codeänderungen zu integrieren, lediglich durch Änderung der Basisadresse und des Schlüssels der API.
2. Effiziente Verwaltung von Mehrfachkonten
   Für Benutzer oder Teams mit mehreren Grok-Konten ist es sehr mühsam, die Konten manuell zu verwalten und zu rotieren. Die grok2api-Funktionen zur Bündelung von Nummern und zum automatischen Lastausgleich können dieses Problem lösen. Die Benutzer müssen nur alle Konten im Hintergrund hinzufügen, das System wird die Anfragen automatisch zuweisen, um sicherzustellen, dass die Häufigkeit der Nutzung jedes Kontos ausgeglichen ist, um Serviceunterbrechungen aufgrund von Überschreitung des Limits zu vermeiden und um die Nutzung aller Kontoressourcen zu maximieren.
3. Kostengünstige API-Alternativen
   Für einzelne Entwickler, Forscher oder Start-ups, die eine große Modell-API nutzen müssen, aber nur über ein begrenztes Budget verfügen, bietet grok2api eine sehr kostengünstige Lösung. Sie ermöglicht es den Nutzern, die Leistungsfähigkeit von Grok für Experimente, Prototyping oder kleinere Anwendungen nahezu kostenlos zu nutzen, indem sie die webseitigen Operationen in eine API-Schnittstelle umwandelt.
4. Erstellung multimedialer Inhalte
   Ersteller von Inhalten oder Automatisierungsanwendungen, die Bilder oder kurze Videos generieren müssen, können die Vorteile der Multimedia-Generierungsfunktionen von grok2api nutzen. Mit einem einfachen API-Aufruf können visuelle Inhalte auf der Grundlage von Text- oder Bildvorgaben für Beiträge in sozialen Medien, Marketingmaterialien oder automatisierte Videoproduktionsprozesse generiert werden.

QA

1. Muss ich für die Nutzung von grok2api bezahlen?
   Das grok2api-Projekt selbst ist quelloffen und kostenlos. Sie benötigen jedoch mindestens ein Grok-Konto (regulär oder Super), um seine Funktionen nutzen zu können. Nach der offiziellen Politik von Grok gibt es eine Begrenzung der Anzahl der Anrufe (z. B. 80 pro 20 Stunden) für reguläre Konten.
2. Ist dieses Projekt eine offizielle API?
   Nicht. Dieses Projekt ist ein Drittanbieter-Tool, das seine Funktionalität in einer API-Schnittstelle kapselt, indem es die Interaktion eines Browsers mit der Web-Version von Grok simuliert. Als solches kann seine Stabilität durch Aktualisierungen der offiziellen Grok-Webversion beeinträchtigt werden.
3. Wie erhalte ich die Authentifizierungsinformationen des Grok-Kontos (cf_clearance im Gesang antworten auth_token)?
   Sie müssen sich auf der offiziellen Website von Grok anmelden und dann die Entwicklertools Ihres Browsers verwenden (in der Regel durch Drücken von F12), um das entsprechende Cookie und die Header-Informationen auf der Registerkarte Netzwerk oder Anwendung zu finden. Da es sich hierbei um einen hochtechnischen Vorgang handelt, sollten Sie Ihre persönlichen Authentifizierungsdaten mit Vorsicht behandeln.
4. Warum können die erzeugten Bilder oder Videos nicht angezeigt werden?
   Dies ist in der Regel darauf zurückzuführen, dass die Einstellungbase_urlParameter. Die von Grok zurückgegebenen Links zu Mediendateien unterliegen Zugriffsbeschränkungen, und grok2api speichert sie lokal. Sie müssen diebase_urlAuf die öffentlich zugängliche Adresse des Dienstes setzen (z. B. https://yourdomain.com vielleicht http://<服务器IP>:8000), damit die von der API zurückgegebenen Medienlinks zugänglich sind.