中文

Genspark2API

觉得有点意思的话 别忘了点个 ⭐

Telegram 交流群

^{(原coze-discord-proxy交流群, 此项目仍可进此群交流 / 反馈bug) (群内提供公益API、AI机器人)}

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

功能

• 支持对话接口(流式/非流式)(/chat/completions)(请求非以下列表的模型会触发Mixture-of-Agents模式)
  • gpt-4o
  • o1
  • o3-mini-high
  • claude-3-5-sonnet
  • claude-3-7-sonnet
  • claude-3-7-sonnet-thinking
  • claude-3-5-haiku
  • gemini-2.0-flash
  • deep-seek-v3
  • deep-seek-r1
• 支持联网搜索,在模型名后添加-search即可(如:gpt-4o-search)
• 支持识别图片/文件多轮对话
• 支持文生图接口(/images/generations)
  • flux
  • flux-speed
  • flux-pro/ultra
  • ideogram
  • ideogram/V_2A
  • recraft-v3
  • dall-e-3
  • imagen3
• 支持文/图生视频接口(/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

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

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 #  [可选] 推荐(住宅)动态代理,配置代理后过验证概率更高,但响应会变慢。

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

3. 重启genspark2api服务。

报错排查

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

字段 Field	类型 Type	必填 Required	描述 Description	可选值 Accepted Values
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",
    }
  ]
}

其他

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