Hugging Face's logo

Spaces:
clash-linux
/
genspark2api
Paused

App Files Community
genspark2api / README.md
clash-linux's picture
clash-linux
Update README.md
cfcc876 verified
preview code
|
raw
history blame contribute delete
13.3 kB
metadata
title: API Proxy
emoji: 🚀
colorFrom: blue
colorTo: green
sdk: docker
app_port: 7055

中文

Genspark2API

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

Telegram 交流群

AI Wave 社群 · (群内提供公益API、AI机器人)

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

功能

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

Deployed on 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用法一致)

保存。

  1. 选择 Redeploy。
部署到 Hugging Face

Hugging Face Spaces 提供免费的 Docker 容器部署服务。

  1. 在 Hugging Face 上创建一个新的 Space: https://huggingface.co/new-space
  2. Owner 选择你自己, Space name 随意填写。
  3. Select the Space SDK 选择 Docker。
  4. Docker template 选择 Blank。
  5. Space hardware 选择免费的 CPU upgrade。
  6. 点击 Create Space。
  7. 你会进入到仓库的文件页面, 点击 Add file -> Create a new file。
  8. 文件名填写 Dockerfile。
  9. 在 Dockerfile 中输入以下内容:
    FROM ghcr.io/deanxv/genspark2api:latest
    然后点击 Commit new file。
  10. 进入 Space 的 Settings 页面, 在左侧菜单选择 Variables and secrets。
  11. 点击 New secret 添加以下环境变量:
    • GS_COOKIE: 必须, 你的 Genspark Cookie。
    • API_SECRET: 推荐, 你的 API 密钥, 用于保护你的服务。
    • 其他可选环境变量请参考 环境变量 章节。
  12. 添加完环境变量后, Hugging Face 会自动重新构建和部署你的 Space。部署完成后, 你的 API 地址就是 https://<space-name>.hf.space。
部署到 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

img.png

进阶配置

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

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

配置环境变量 AUTO_MODEL_CHAT_MAP_TYPE=1

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

方案二

配置环境变量 MODEL_CHAT_MAP

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

  1. 打开F12开发者工具。
  2. 选择需要绑定的对话的模型(示例:claude-3-7-sonnet),发起对话。
  3. 点击ask请求,此时最上方url中的id(或响应中的id)即为此对话唯一id。 img.png
  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
  • 接口描述：获取用户认证令牌
请求参数
请求头
参数名 必选 类型 说明
cookie 是 string 用户会话凭证
响应参数
响应示例 
{
  "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

字段 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