⚠️目前官方强制校验ReCaptchaV3不通过则模型降智/生图异常,请参考genspark-playwright-prxoy服务过V3验证并配置环境变量RECAPTCHA_PROXY_URL。

部署

基于 Docker-Compose(All In One) 进行部署

docker-compose pull && docker-compose up -d

docker-compose.yml

version: '3.4'

services:
  genspark2api:
    image: deanxv/genspark2api:latest
    container_name: genspark2api
    restart: always
    ports:
      - "7055:7055"
    volumes:
      - ./data:/app/genspark2api/data
    environment:
      - GS_COOKIE=******  # cookie (多个请以,分隔)
      - API_SECRET=123456  # [可选]接口密钥-修改此行为请求头校验的值(多个请以,分隔)
      - TZ=Asia/Shanghai

基于 Docker 进行部署

docker run --name genspark2api -d --restart always \
-p 7055:7055 \
-v $(pwd)/data:/app/genspark2api/data \
-e GS_COOKIE=***** \
-e API_SECRET="123456" \
-e TZ=Asia/Shanghai \
deanxv/genspark2api

其中API_SECRET、GS_COOKIE修改为自己的。

如果上面的镜像无法拉取,可以尝试使用 GitHub 的 Docker 镜像,将上面的deanxv/genspark2api替换为ghcr.io/deanxv/genspark2api即可。

部署到第三方平台

部署到 Zeabur

Zeabur 的服务器在国外,自动解决了网络的问题,同时免费的额度也足够个人使用

1. 首先 fork 一份代码。

2. 进入 Zeabur,使用github登录,进入控制台。

3. 在 Service -> Add Service,选择 Git（第一次使用需要先授权）,选择你 fork 的仓库。

4. Deploy 会自动开始,先取消。

5. 添加环境变量

   GS_COOKIE:****** cookie (多个请以,分隔)

   API_SECRET:123456 [可选]接口密钥-修改此行为请求头校验的值(多个请以,分隔)(与openai-API-KEY用法一致)

保存。

6. 选择 Redeploy。

部署到 Render

Render 提供免费额度,绑卡后可以进一步提升额度

Render 可以直接部署 docker 镜像,不需要 fork 仓库：Render

配置

环境变量

1. PORT=7055 [可选]端口,默认为7055
2. DEBUG=true [可选]DEBUG模式,可打印更多信息[true:打开、false:关闭]
3. API_SECRET=123456 [可选]接口密钥-修改此行为请求头(Authorization)校验的值(同API-KEY)(多个请以,分隔)
4. GS_COOKIE=****** cookie (多个请以,分隔)
5. AUTO_DEL_CHAT=0 [可选]对话完成自动删除(默认:0)[0:关闭,1:开启]
6. REQUEST_RATE_LIMIT=60 [可选]每分钟下的单ip请求速率限制,默认:60次/min
7. PROXY_URL=http://127.0.0.1:10801 [可选]代理
8. RECAPTCHA_PROXY_URL=http://127.0.0.1:7022 [可选]genspark-playwright-prxoy验证服务地址，仅填写域名或ip:端口即可。(示例:RECAPTCHA_PROXY_URL=https://genspark-playwright-prxoy.com或RECAPTCHA_PROXY_URL=http://127.0.0.1:7022),详情请看genspark-playwright-prxoy服务过V3验证
9. AUTO_MODEL_CHAT_MAP_TYPE=1 [可选]自动配置Model绑定Chat(默认:1)[0:关闭,1:开启]
10. MODEL_CHAT_MAP=claude-3-7-sonnet=a649******00fa,gpt-4o=su74******47hd [可选]Model绑定Chat(多个请以,分隔),详细请看进阶配置
11. ROUTE_PREFIX=hf [可选]路由前缀,默认为空,添加该变量后的接口示例:/hf/v1/chat/completions
12. RATE_LIMIT_COOKIE_LOCK_DURATION=600 [可选]到达速率限制的cookie禁用时间,默认为600s
13. REASONING_HIDE=0 [可选]隐藏推理过程(默认:0)[0:关闭,1:开启]

cookie获取方式

1. 打开F12开发者工具。
2. 发起对话。
3. 点击ask请求,请求头中的cookie即为环境变量GS_COOKIE所需值。

【注】 其中session_id=f9c60******cb6d是必须的,其他内容可要可不要,即环境变量GS_COOKIE=session_id=f9c60******cb6d

进阶配置

解决模型自动切换导致降智问题

方案一 (默认启用此配置)【推荐】

配置环境变量 AUTO_MODEL_CHAT_MAP_TYPE=1

此配置下,会在调用模型时获取对话的id,并绑定模型。

方案二

配置环境变量 MODEL_CHAT_MAP

【作用】指定对话,解决模型自动切换导致降智问题。

1. 打开F12开发者工具。
2. 选择需要绑定的对话的模型(示例:claude-3-7-sonnet),发起对话。
3. 点击ask请求,此时最上方url中的id(或响应中的id)即为此对话唯一id。
4. 配置环境变量 MODEL_CHAT_MAP=claude-3-7-sonnet=3cdcc******474c5 (多个请以,分隔)

genspark-playwright-prxoy服务过V3验证

1. docker部署genspark-playwright-prxoy

docker

docker run --name genspark-playwright-proxy -d --restart always \
-p 7022:7022 \
-v $(pwd)/data:/app/genspark-playwright-proxy/data \
-e PROXY_URL=http://account:pwd@ip:port #  [可选] 推荐(住宅)动态代理,配置代理后过验证概率更高,但响应会变慢。
-e TZ=Asia/Shanghai \
deanxv/genspark-playwright-proxy

docker-compose

version: '3.4'

services:
  genspark-playwright-prxoy:
    image: deanxv/genspark-playwright-proxy:latest
    container_name: genspark-playwright-prxoy
    restart: always
    ports:
      - "7022:7022"
    volumes:
      - ./data:/app/genspark-playwright-prxoy/data
    environment:
      - PROXY_URL=http://account:pwd@ip:port #  [可选] 推荐(住宅)动态代理,配置代理后过验证概率更高,但响应会变慢。

1. 部署后配置genspark2api环境变量RECAPTCHA_PROXY_URL，仅填写域名或ip:端口即可。(示例:RECAPTCHA_PROXY_URL=https://genspark-playwright-prxoy.com或RECAPTCHA_PROXY_URL=http://127.0.0.1:7022)

2. 重启genspark2api服务。

生视频请求格式

Request

Endpoint: POST /v1/videos/generations

Content-Type: application/json

Request Parameters

字段	类型	必填	描述	可选值
model	string	是	使用的视频生成模型	模型列表: kling/v1.6/standard|pixverse/v3.5/turbo|lumadream/ray-2|gemini/veo2|hunyuan
aspect_ratio	string	是	视频宽高比	9:16 | 16:9 | 3:4 |1:1 | 4:3
duration	int	是	视频时长（单位：秒）	正整数
prompt	string	是	生成视频的文本描述	-
auto_prompt	bool	是	是否自动优化提示词	true | false
image	string	否	用于视频生成的基底图片（Base64编码/url）	Base64字符串/url

---

Response

Response Object

{
  "created": 1677664796,
  "data": [
    {
      "url": "https://example.com/video.mp4",
    }
  ]
}