Allgemeine Einführung
genspark2api 是一个开源的 API 服务工具,托管在 GitHub 上,由开发者 deanxv 创建。它提供了一个支持多模型对话、文生图和文生视频的接口服务,用户可以通过 Docker 快速部署在本地或服务器上。这个工具的核心功能是让开发者轻松调用多种对话模型(如 gpt-4o、claude-3-5-sonnet)和生成工具(如 flux、dall-e-3),支持联网搜索和图片识别等多轮对话。项目版本目前为 3.4,代码完全公开,用户可以自由修改。它的设计目标是简化开发流程,适合技术爱好者或小型团队使用。
Funktionsliste
- 支持多种对话模型接口(流式和非流式),如
gpt-4o
, undclaude-3-5-sonnet
,未支持模型会自动切换到 Mixture-of-Agents 模式。 - 提供联网搜索功能,在模型名后加
-search
即可使用,例如gpt-4o-search
. - 支持图片和文件识别的多轮对话,用户可以上传内容进行交互。
- 提供文生图接口
/images/generations
,支持模型如flux
, unddall-e-3
. - 支持文生视频和图生视频接口
/videos/generations
,可用模型包括kling/v1.6/standard
. - 通过 cookie 池和自动重试机制提升服务稳定性。
- 支持自定义接口密钥(
API_SECRET
)和代理配置(PROXY_URL
). - 允许绑定模型和对话,防止模型切换导致响应质量下降。
Hilfe verwenden
Ablauf der Installation
genspark2api 依赖 Docker 部署,适合有基础技术能力的用户。以下是详细步骤:
- Installation von Docker
在电脑或服务器上安装 Docker。访问https://www.docker.com/
下载并安装。安装后运行以下命令确认:
docker --version
如果显示版本号,说明环境就绪。
- Spiegel abziehen
在终端输入命令拉取最新镜像:
docker pull deanxv/genspark2api:latest
如果拉取失败,可用 GitHub 镜像:
docker pull ghcr.io/deanxv/genspark2api:latest
- Umgebungsvariablen konfigurieren
创建一个本地文件夹(如. /Daten
)存储数据。准备以下变量:
GS_COOKIE
: Von genspark 官网获取的 cookie,多个用逗号分隔。API_SECRET
:自定义密钥,如 "123456",用于接口安全校验。TZ
:时区,如 "Asia/Shanghai"。
示例运行命令:
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
- 启动并验证
运行后,访问http://localhost:7055
检查服务状态。如果需要查看日志:
docker logs genspark2api
获取 cookie
- 打开浏览器,按 F12 进入开发者工具。
- Interviews
https://www.genspark.ai
,发起一次对话。 - 在“网络”选项卡中找到
fragen Sie
请求,复制请求头中的cookie
值。
Muss enthalten,session_id=xxx,, andere Teile sind optional. ,,Dialogschnittstelle verwenden,,Dialogschnittstellenpfad ist ,,Streaming- und Nicht-Streaming-Ausgabe wird unterstützt. ,(nicht-streaming):,curl -X POST http://localhost:7055/chat/completions -H "Autorisierung: Bearer 123456" -H "Content-Type: application/json" -d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "hello"}]}',,Die Daten werden in Chunks zurückgegeben. ,return example,{"choices": [{"message": {"role": "assistant", "content": "Hallo! Wie kann ich Ihnen helfen?"}}]} ,Verwenden Sie die Schnittstelle für textgenerierte Bilder, Pfad zu ,, um die Erstellung von Bildern zu unterstützen. ,curl -X POST http://localhost:7055/images/generations -H "Authorization: Bearer 123456" -H "Content-Type: application/json" -d '{"model": "flux", "prompt": "A cat playing in the grass"}',{"data": [{"url": "https://example.com/image.jpg"}]},,Verwenden Sie die Vincennes-Videoschnittstelle,,die die Erzeugung von Videos aus Text oder Bildern unterstützt. (Texterzeugung):,curl -X POST http://localhost:7055/videos/generations -H "Autorisierung: Bearer 123456" -H "Content-Type: application/json" -d '{"model": "kling/v1.6/standard", "prompt": "City Night View", "aspect_ratio": "16:9", "duration": 10, "auto_prompt": true}',{"created": 1677664796, " data": [{"url": "https://example.com/video.mp4"}]},Konfigurieren Sie die ReCaptcha-Validierung, die offiziell von der ReCaptchaV3-Validierung gefordert wird, da das Modell sonst möglicherweise herabgestuft oder abnormal generiert wird. Muss mit,genspark-playwright-proxy,service:,Bereitstellen des Proxy-Dienstes:,docker run --name genspark-playwright-proxy -d --restart always -p 7022:7022 -v . /data:/app/genspark-playwright-proxy/data -e TZ="Asien/Shanghai" deanxv/genspark-playwright-proxy:latest, Umgebungsvariable in genspark2api hinzufügen: ,-e RECAPTCHA_PROXY_URL="http://127.0.0.1:7022", Dienst neu starten, um Wirkung zu zeigen. Die Schnittstelle meldet "Alle Cookies sind vorübergehend nicht verfügbar", Alle Cookies haben das Ratenlimit erreicht. Ersetzen Sie sie durch neue, oder warten Sie eine Weile. ,Abfangen von Cloudflare,-e PROXY_URL="http://127.0.0.1:10801",Bauen Sie über die Dialogschnittstelle schnell einen Kundendienst-Bot auf, der eine vernetzte Suche und einen Dialog mit mehreren Runden unterstützt, um Kundenfragen zu beantworten. Generieren Sie kreative Inhalte, verwenden Sie die Text-zu-Grafik- und Text-zu-Video-Funktionen, um Beschreibungen einzugeben und Bilder oder kurze Videos für die Verwendung in Design-Prototypen oder Inhalten für soziale Medien zu generieren. Für die Ausbildung und das technische Lernen können Studenten oder Entwickler den Dienst einsetzen, verschiedene Modelle zum Experimentieren aufrufen und APIs und Modellintegration kennenlernen. Welche Dialogmodelle werden unterstützt? Es wird eine Vielzahl von Modellen unterstützt, und nicht aufgeführte Modelle lösen den Mixture-of-Agents-Modus aus. Was sollte ich tun, wenn ich RECAPTCHART nicht verwenden kann? RECAPTCHA_PROXY_URL, ist sie richtig konfiguriert, stellen Sie sicher, dass sie die ReCaptchaV3-Validierung besteht. Wie kann man die Stabilität des Dienstes verbessern? Konfigurieren Sie mehrere,,Aktivieren Sie das Cookie-Pooling und den automatischen Wechsel, wenn die Anfrage fehlschlägt. genspark2api ist ein quelloffenes Reverse-API-Tool, das Dialoge mit mehreren Modellen, Text-zu-Grafik und Text-zu-Video unterstützt. Es wird über Docker bereitgestellt, kann von Benutzern mit einfachen Befehlen ausgeführt werden und bietet Streaming-Ausgabe, vernetzte Suche und Bilderkennung und kann mit Cookie-Pools und Schlüsseln konfiguriert werden, um Stabilität und Sicherheit zu verbessern. Genspark2api-Chief AI Sharing Circlesession_id=xxx
,其他部分可选。
使用对话接口
对话接口路径为 /chat/erledigungen
,支持流式和非流式输出。
- Beispiel für einen Antrag(非流式):
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
"Strom": wahr
,数据会分块返回。 - 返回示例::
{"choices": [{"message": {"role": "assistant", "content": "你好!有什么可以帮助你的吗?"}}]}
使用文生图接口
路径为 /images/generations
,支持生成图片。
- 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": "一只猫在草地上玩耍"}'
- 返回示例::
{"data": [{"url": "https://example.com/image.jpg"}]}
使用文生视频接口
路径为 /videos/generations
,支持文本或图片生成视频。
- Beispiel für einen Antrag(文本生成):
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}'
- 返回示例::
{"created": 1677664796, "data": [{"url": "https://example.com/video.mp4"}]}
配置 ReCaptcha 验证
官方要求通过 ReCaptchaV3 验证,否则模型可能降智或生成异常。需要配合 genspark-playwright-proxy
服务:
- 部署代理服务:
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
- 在 genspark2api 中添加环境变量:
-e RECAPTCHA_PROXY_URL="http://127.0.0.1:7022"
- 重启服务生效。
Häufig gestellte Fragen
- 接口返回 "All cookies are temporarily unavailable"
所有 cookie 达到速率限制。更换新的GS_COOKIE
或等待一段时间。 - 遇到 Cloudflare 拦截
konfigurieren.PROXY_URL
z.B..-e PROXY_URL="http://127.0.0.1:10801"
.
Anwendungsszenario
- Entwicklung eines intelligenten Kundendienstes
通过对话接口快速搭建客服机器人,支持联网搜索和多轮对话,回答客户问题。 - 生成创意内容
使用文生图和文生视频功能,输入描述生成图片或短视频,用于设计原型或社交媒体内容。 - 教育和技术学习
学生或开发者可以部署服务,调用不同模型进行实验,学习 API 和模型集成。
QA
- 支持哪些对话模型?
Adjuvansgpt-4o
, undclaude-3-5-sonnet
等多种模型,未列出模型会触发 Mixture-of-Agents 模式。 - 文生图失败怎么办?
SondeRECAPTCHA_PROXY_URL
是否配置正确,确保通过 ReCaptchaV3 验证。 - 如何提升服务稳定性?
配置多个GS_COOKIE
,启用 cookie 池,请求失败时自动切换。