genspark2api

中文

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

功能

• 支持对话接口(流式/非流式)(/chat/completions)(请求非以下列表的模型会触发Mixture-of-Agents模式)
  • gpt-5-minimal
  • gpt-5
  • gpt-5-high
  • gpt-5-pro
  • gpt-4.1
  • o1
  • o3
  • o3-pro
  • o4-mini-high
  • claude-3-7-sonnet-thinking
  • claude-3-7-sonnet
  • claude-sonnet-4-5
  • claude-sonnet-4-thinking
  • claude-sonnet-4
  • claude-opus-4-1
  • claude-opus-4
  • gemini-2.5-pro
  • gemini-2.5-flash
  • gemini-2.0-flash
  • deep-seek-v3
  • deep-seek-r1
  • grok-4-0709
• 支持联网搜索,在模型名后添加-search即可(如:gpt-4o-search)
• 支持识别图片/文件多轮对话
• 支持文生图接口(/images/generations)
  • fal-ai/nano-banana
  • fal-ai/bytedance/seedream/v4
  • gpt-image-1
  • flux-pro/ultra
  • flux-pro/kontext/pro
  • imagen4
• 支持文/图生视频接口(/videos/generations),详情查看文/图生视频请求格式
• 支持自定义请求头校验值(Authorization)
• 支持cookie池(随机)
• 支持请求失败自动切换cookie重试(需配置cookie池)
• 可配置自动删除对话记录
• 可配置代理请求(环境变量PROXY_URL)
• 可配置Model绑定Chat(解决模型自动切换导致降智),详细请看进阶配置。

接口文档:

略

示例:

如何使用

略

如何集成NextChat

填 接口地址(ip:端口/域名) 及 API-Key(PROXY_SECRET),其它的随便填随便选。

如果自己没有搭建NextChat面板,这里有个已经搭建好的可以使用 NeatChat

如何集成one-api

填 BaseURL(ip:端口/域名) 及 密钥(PROXY_SECRET),其它的随便填随便选。

部署

基于 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

部署到 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:开启]

14. SESSION_IMAGE_CHAT_MAP=aed9196b-********-4ed6e32f7e4d=0c6785e6-********-7ff6e5a2a29c,aefwer6b-********-casds22=fda234-********-sfaw123 [可选] Session绑定Image-Chat(多个请以,分隔),详细请看进阶配置

15. YES_CAPTCHA_CLIENT_KEY=****** [可选]YesCaptcha Client Key 过谷歌验证,详细请看使用YesCaptcha过谷歌验证

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服务。

接入自定义Recaptcha服务

接口：获取令牌

基本信息

• 接口地址：/genspark
• 请求方式：GET
• 接口描述：获取用户认证令牌

请求参数

请求头

响应参数

响应示例

{
  "code": 200,
  "token": "ey********pe"
}

报错排查

Detected Cloudflare Challenge Page

被Cloudflare拦截出5s盾,可配置PROXY_URL。

(【推荐方案】自建ipv6代理池绕过cf对ip的速率限制及5s盾 或购买IProyal)

Genspark Service Unavailable

Genspark官方服务不可用,请稍后再试。

All cookies are temporarily unavailable.

所有用户(cookie)均到达速率限制,更换用户cookie或稍后再试。

生视频请求格式

Request

Endpoint: POST /v1/videos/generations

Content-Type: application/json

Request Parameters

Response

Response Object

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

其他

Genspark( 注册领取1个月Plus): https://www.genspark.ai