Genspark2api (실패)

일반 소개

genspark2api 是一个开源的 API 服务工具，托管在 GitHub 上，由开发者 deanxv 创建。它提供了一个支持多模型对话、文生图和文生视频的接口服务，用户可以通过 Docker 快速部署在本地或服务器上。这个工具的核心功能是让开发者轻松调用多种对话模型（如 gpt-4o、claude-3-5-sonnet）和生成工具（如 flux、dall-e-3），支持联网搜索和图片识别等多轮对话。项目版本目前为 3.4，代码完全公开，用户可以自由修改。它的设计目标是简化开发流程，适合技术爱好者或小型团队使用。

 

기능 목록

• 支持多种对话模型接口（流式和非流式），如 gpt-4o및claude-3-5-sonnet，未支持模型会自动切换到 Mixture-of-Agents 模式。
• 提供联网搜索功能，在模型名后加 -search 即可使用，例如 gpt-4o-search.
• 支持图片和文件识别的多轮对话，用户可以上传内容进行交互。
• 提供文生图接口 /images/generations，支持模型如 flux및dall-e-3.
• 支持文生视频和图生视频接口 /videos/generations，可用模型包括 kling/v1.6/standard.
• 通过 cookie 池和自动重试机制提升服务稳定性。
• 支持自定义接口密钥（API_SECRET）和代理配置（PROXY_URL).
• 允许绑定模型和对话，防止模型切换导致响应质量下降。

 

도움말 사용

설치 프로세스

genspark2api 依赖 Docker 部署，适合有基础技术能力的用户。以下是详细步骤：

1. Docker 설치
   在电脑或服务器上安装 Docker。访问 https://www.docker.com/ 下载并安装。安装后运行以下命令确认：

docker --version

如果显示版本号，说明环境就绪。

2. 거울 당기기
   在终端输入命令拉取最新镜像：

docker pull deanxv/genspark2api:latest

如果拉取失败，可用 GitHub 镜像：

docker pull ghcr.io/deanxv/genspark2api:latest

3. 환경 변수 구성
   创建一个本地文件夹（如 ./data）存储数据。准备以下变量：

• GS_COOKIE: 출발지 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

4. 启动并验证
   运行后，访问 http://localhost:7055 检查服务状态。如果需要查看日志：

docker logs genspark2api

获取 cookie

1. 打开浏览器，按 F12 进入开发者工具。
2. 인터뷰 https://www.genspark.ai，发起一次对话。
3. 在“网络”选项卡中找到 ask 请求，复制请求头中的 cookie 가치.
   必须包含 session_id=xxx，其他部分可选。

使用对话接口

对话接口路径为 /chat/completions，支持流式和非流式输出。

• 请求示例（非流式）：

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": "你好"}]}'

• 스트리밍 출력추가 "stream": true，数据会分块返回。
• 返回示例::

{"choices": [{"message": {"role": "assistant", "content": "你好！有什么可以帮助你的吗？"}}]}

使用文生图接口

路径为 /images/generations，支持生成图片。

• 请求示例::

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，支持文本或图片生成视频。

• 请求示例（文本生成）：

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 서비스:

1. 部署代理服务：

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

2. 在 genspark2api 中添加环境变量：

-e RECAPTCHA_PROXY_URL="http://127.0.0.1:7022"

3. 重启服务生效。

자주 묻는 질문

• 接口返回 "All cookies are temporarily unavailable"
  所有 cookie 达到速率限制。更换新的 GS_COOKIE 或等待一段时间。
• 遇到 Cloudflare 拦截
  구성 PROXY_URL예 -e PROXY_URL="http://127.0.0.1:10801".

 

애플리케이션 시나리오

1. 开发智能客服
   通过对话接口快速搭建客服机器人，支持联网搜索和多轮对话，回答客户问题。
2. 生成创意内容
   使用文生图和文生视频功能，输入描述生成图片或短视频，用于设计原型或社交媒体内容。
3. 教育和技术学习
   学生或开发者可以部署服务，调用不同模型进行实验，学习 API 和模型集成。

 

QA

1. 支持哪些对话模型？
   지원 gpt-4o및claude-3-5-sonnet 等多种模型，未列出模型会触发 Mixture-of-Agents 模式。
2. 文生图失败怎么办？
   프로브 RECAPTCHA_PROXY_URL 是否配置正确，确保通过 ReCaptchaV3 验证。
3. 如何提升服务稳定性？
   配置多个 GS_COOKIE，启用 cookie 池，请求失败时自动切换。