{"id":26896694,"url":"https://github.com/deanxv/genspark2api","last_synced_at":"2026-03-03T17:08:01.424Z","repository":{"id":269422911,"uuid":"907366348","full_name":"deanxv/genspark2api","owner":"deanxv","description":null,"archived":false,"fork":false,"pushed_at":"2026-02-22T13:37:35.000Z","size":2443,"stargazers_count":620,"open_issues_count":5,"forks_count":200,"subscribers_count":8,"default_branch":"main","last_synced_at":"2026-02-22T18:54:58.506Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/deanxv.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-12-23T12:23:34.000Z","updated_at":"2026-02-22T13:37:39.000Z","dependencies_parsed_at":"2025-01-07T07:18:42.925Z","dependency_job_id":"badeef63-77c9-4f4d-9a2d-cdb506d77521","html_url":"https://github.com/deanxv/genspark2api","commit_stats":null,"previous_names":["deanxv/genspark2api"],"tags_count":83,"template":false,"template_full_name":null,"purl":"pkg:github/deanxv/genspark2api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deanxv%2Fgenspark2api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deanxv%2Fgenspark2api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deanxv%2Fgenspark2api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deanxv%2Fgenspark2api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/deanxv","download_url":"https://codeload.github.com/deanxv/genspark2api/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deanxv%2Fgenspark2api/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30052287,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-03T15:26:47.567Z","status":"ssl_error","status_checked_at":"2026-03-03T15:26:17.132Z","response_time":61,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-04-01T04:01:29.587Z","updated_at":"2026-03-03T17:08:01.403Z","avatar_url":"https://github.com/deanxv.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"\u003cp align=\"right\"\u003e\n   \u003cstrong\u003e中文\u003c/strong\u003e \n\u003c/p\u003e\n\u003cdiv align=\"center\"\u003e\n\n# Genspark2API\n\n_觉得有点意思的话 别忘了点个 ⭐_\n\n\u003ca href=\"https://t.me/+raL5ppEzDIFmZTY1\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Telegram-AI Wave交流群-0088cc?style=for-the-badge\u0026logo=telegram\u0026logoColor=white\" alt=\"Telegram 交流群\" /\u003e\n\u003c/a\u003e\n\n\u003csup\u003e\u003ci\u003eAI Wave 社群\u003c/i\u003e\u003c/sup\u003e · \u003csup\u003e\u003ci\u003e(群内提供公益API、AI机器人)\u003c/i\u003e\u003c/sup\u003e\n\n\n\u003c/div\u003e\n\n\u003e ⚠️目前官方强制校验`ReCaptchaV3`\n\u003e 不通过则模型降智/生图异常,请参考[genspark-playwright-prxoy服务过V3验证](#genspark-playwright-prxoy服务过V3验证)并配置环境变量\n`RECAPTCHA_PROXY_URL`。\n\n## 功能\n\n- [x] 支持对话接口(流式/非流式)(`/chat/completions`)(请求非以下列表的模型会触发`Mixture-of-Agents`模式)\n    - **gpt-5-minimal**\n    - **gpt-5**\n    - **gpt-5-high**\n    - **gpt-5-pro**\n    - **gpt-4.1**\n    - **o1**\n    - **o3**\n    - **o3-pro**\n    - **o4-mini-high**\n    - **claude-3-7-sonnet-thinking**\n    - **claude-3-7-sonnet**\n    - **claude-sonnet-4-5**\n    - **claude-sonnet-4-thinking**\n    - **claude-sonnet-4**\n    - **claude-opus-4-1**\n    - **claude-opus-4**\n    - **gemini-2.5-pro**\n    - **gemini-2.5-flash**\n    - **gemini-2.0-flash**\n    - **deep-seek-v3**\n    - **deep-seek-r1**\n    - **grok-4-0709**\n- [x] 支持**联网搜索**,在模型名后添加`-search`即可(如:`gpt-4o-search`)\n- [x] 支持识别**图片**/**文件**多轮对话\n- [x] 支持文生图接口(`/images/generations`)\n    - **fal-ai/nano-banana**\n    - **fal-ai/bytedance/seedream/v4**\n    - **gpt-image-1**\n    - **flux-pro/ultra**\n    - **flux-pro/kontext/pro**\n    - **imagen4**\n- [x] 支持文/图生视频接口(`/videos/generations`),详情查看[文/图生视频请求格式](#生视频请求格式)\n- [x] 支持自定义请求头校验值(Authorization)\n- [x] 支持cookie池(随机)\n- [x] 支持请求失败自动切换cookie重试(需配置cookie池)\n- [x] 可配置自动删除对话记录\n- [x] 可配置代理请求(环境变量`PROXY_URL`)\n- [x] 可配置Model绑定Chat(解决模型自动切换导致**降智**),详细请看[进阶配置](#解决模型自动切换导致降智问题)。\n\n### 接口文档:\n\n略\n\n### 示例:\n\n\u003cspan\u003e\u003cimg src=\"docs/img2.png\" width=\"800\"/\u003e\u003c/span\u003e\n\n## 如何使用\n\n略\n\n## 如何集成NextChat\n\n填 接口地址(ip:端口/域名) 及 API-Key(`PROXY_SECRET`),其它的随便填随便选。\n\n\u003e 如果自己没有搭建NextChat面板,这里有个已经搭建好的可以使用 [NeatChat](https://ai.aytsao.cn/)\n\n\u003cspan\u003e\u003cimg src=\"docs/img5.png\" width=\"800\"/\u003e\u003c/span\u003e\n\n## 如何集成one-api\n\n填 `BaseURL`(ip:端口/域名) 及 密钥(`PROXY_SECRET`),其它的随便填随便选。\n\n\u003cspan\u003e\u003cimg src=\"docs/img3.png\" width=\"800\"/\u003e\u003c/span\u003e\n\n## 部署\n\n### 基于 Docker-Compose(All In One) 进行部署\n\n```shell\ndocker-compose pull \u0026\u0026 docker-compose up -d\n```\n\n#### docker-compose.yml\n\n```docker\nversion: '3.4'\n\nservices:\n  genspark2api:\n    image: deanxv/genspark2api:latest\n    container_name: genspark2api\n    restart: always\n    ports:\n      - \"7055:7055\"\n    volumes:\n      - ./data:/app/genspark2api/data\n    environment:\n      - GS_COOKIE=******  # cookie (多个请以,分隔)\n      - API_SECRET=123456  # [可选]接口密钥-修改此行为请求头校验的值(多个请以,分隔)\n      - TZ=Asia/Shanghai\n```\n\n### 基于 Docker 进行部署\n\n```docker\ndocker run --name genspark2api -d --restart always \\\n-p 7055:7055 \\\n-v $(pwd)/data:/app/genspark2api/data \\\n-e GS_COOKIE=***** \\\n-e API_SECRET=\"123456\" \\\n-e TZ=Asia/Shanghai \\\ndeanxv/genspark2api\n```\n\n其中`API_SECRET`、`GS_COOKIE`修改为自己的。\n\n如果上面的镜像无法拉取,可以尝试使用 GitHub 的 Docker 镜像,将上面的`deanxv/genspark2api`替换为\n`ghcr.io/deanxv/genspark2api`即可。\n\n### 部署到第三方平台\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e部署到 Zeabur\u003c/strong\u003e\u003c/summary\u003e\n\u003cdiv\u003e\n\n[![Deployed on Zeabur](https://zeabur.com/deployed-on-zeabur-dark.svg)](https://zeabur.com?referralCode=deanxv\u0026utm_source=deanxv)\n\n\u003e Zeabur 的服务器在国外,自动解决了网络的问题,~~同时免费的额度也足够个人使用~~\n\n1. 首先 **fork** 一份代码。\n2. 进入 [Zeabur](https://zeabur.com?referralCode=deanxv),使用github登录,进入控制台。\n3. 在 Service -\u003e Add Service,选择 Git（第一次使用需要先授权）,选择你 fork 的仓库。\n4. Deploy 会自动开始,先取消。\n5. 添加环境变量\n\n   `GS_COOKIE:******`  cookie (多个请以,分隔)\n\n   `API_SECRET:123456` [可选]接口密钥-修改此行为请求头校验的值(多个请以,分隔)(与openai-API-KEY用法一致)\n\n保存。\n\n6. 选择 Redeploy。\n\n\u003c/div\u003e\n\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e部署到 Render\u003c/strong\u003e\u003c/summary\u003e\n\u003cdiv\u003e\n\n\u003e Render 提供免费额度,绑卡后可以进一步提升额度\n\nRender 可以直接部署 docker 镜像,不需要 fork 仓库：[Render](https://dashboard.render.com)\n\n\u003c/div\u003e\n\u003c/details\u003e\n\n## 配置\n\n### 环境变量\n\n1. `PORT=7055`  [可选]端口,默认为7055\n2. `DEBUG=true`  [可选]DEBUG模式,可打印更多信息[true:打开、false:关闭]\n3. `API_SECRET=123456`  [可选]接口密钥-修改此行为请求头(Authorization)校验的值(同API-KEY)(多个请以,分隔)\n4. `GS_COOKIE=******`  cookie (多个请以,分隔)\n5. `AUTO_DEL_CHAT=0`  [可选]对话完成自动删除(默认:0)[0:关闭,1:开启]\n6. `REQUEST_RATE_LIMIT=60`  [可选]每分钟下的单ip请求速率限制,默认:60次/min\n7. `PROXY_URL=http://127.0.0.1:10801`  [可选]代理\n8. `RECAPTCHA_PROXY_URL=http://127.0.0.1:7022`  [可选]genspark-playwright-prxoy验证服务地址，仅填写域名或ip:端口即可。(\n   示例:`RECAPTCHA_PROXY_URL=https://genspark-playwright-prxoy.com`或`RECAPTCHA_PROXY_URL=http://127.0.0.1:7022`)\n   ,详情请看[genspark-playwright-prxoy服务过V3验证](#genspark-playwright-prxoy服务过V3验证)\n9. `AUTO_MODEL_CHAT_MAP_TYPE=1`  [可选]自动配置Model绑定Chat(默认:1)[0:关闭,1:开启]\n10. `MODEL_CHAT_MAP=claude-3-7-sonnet=a649******00fa,gpt-4o=su74******47hd`  [可选]Model绑定Chat(多个请以,分隔)\n    ,详细请看[进阶配置](#解决模型自动切换导致降智问题)\n11. `ROUTE_PREFIX=hf`  [可选]路由前缀,默认为空,添加该变量后的接口示例:`/hf/v1/chat/completions`\n12. `RATE_LIMIT_COOKIE_LOCK_DURATION=600`  [可选]到达速率限制的cookie禁用时间,默认为600s\n13. `REASONING_HIDE=0`  [可选]**隐藏**推理过程(默认:0)[0:关闭,1:开启]\n\n~~14.\n`SESSION_IMAGE_CHAT_MAP=aed9196b-********-4ed6e32f7e4d=0c6785e6-********-7ff6e5a2a29c,aefwer6b-********-casds22=fda234-********-sfaw123`  [可选]\nSession绑定Image-Chat(多个请以,分隔),详细请看[进阶配置](#生图模型配置)~~\n\n~~15. `YES_CAPTCHA_CLIENT_KEY=******`  [可选]YesCaptcha Client Key\n过谷歌验证,详细请看[使用YesCaptcha过谷歌验证](#使用YesCaptcha过谷歌验证)~~\n\n### cookie获取方式\n\n1. 打开**F12**开发者工具。\n2. 发起对话。\n3. 点击ask请求,请求头中的**cookie**即为环境变量**GS_COOKIE**所需值。\n\n\u003e **【注】** 其中`session_id=f9c60******cb6d`是必须的,其他内容可要可不要,即环境变量`GS_COOKIE=session_id=f9c60******cb6d`\n\n\n![img.png](docs/img.png)\n\n## 进阶配置\n\n### 解决模型自动切换导致降智问题\n\n#### 方案一 (默认启用此配置)【推荐】\n\n\u003e 配置环境变量 **AUTO_MODEL_CHAT_MAP_TYPE=1**\n\u003e\n\u003e 此配置下,会在调用模型时获取对话的id,并绑定模型。\n\n#### 方案二\n\n\u003e 配置环境变量 MODEL_CHAT_MAP\n\u003e\n\u003e 【作用】指定对话,解决模型自动切换导致降智问题。\n\n1. 打开**F12**开发者工具。\n2. 选择需要绑定的对话的模型(示例:`claude-3-7-sonnet`),发起对话。\n3. 点击ask请求,此时最上方url中的`id`(或响应中的`id`)即为此对话唯一id。\n   ![img.png](docs/img4.png)\n4. 配置环境变量 `MODEL_CHAT_MAP=claude-3-7-sonnet=3cdcc******474c5` (多个请以,分隔)\n\n### genspark-playwright-prxoy服务过V3验证\n\n1. docker部署genspark-playwright-prxoy\n\n#### docker\n\n```docker \ndocker run --name genspark-playwright-proxy -d --restart always \\\n-p 7022:7022 \\\n-v $(pwd)/data:/app/genspark-playwright-proxy/data \\\n-e PROXY_URL=http://account:pwd@ip:port #  [可选] 推荐(住宅)动态代理,配置代理后过验证概率更高,但响应会变慢。\n-e TZ=Asia/Shanghai \\\ndeanxv/genspark-playwright-proxy\n```\n\n#### docker-compose\n\n```docker-compose\nversion: '3.4'\n\nservices:\n  genspark-playwright-prxoy:\n    image: deanxv/genspark-playwright-proxy:latest\n    container_name: genspark-playwright-prxoy\n    restart: always\n    ports:\n      - \"7022:7022\"\n    volumes:\n      - ./data:/app/genspark-playwright-prxoy/data\n    environment:\n      - PROXY_URL=http://account:pwd@ip:port #  [可选] 推荐(住宅)动态代理,配置代理后过验证概率更高,但响应会变慢。\n```\n\n2. 部署后配置`genspark2api`环境变量`RECAPTCHA_PROXY_URL`，仅填写域名或ip:端口即可。(示例:\n   `RECAPTCHA_PROXY_URL=https://genspark-playwright-prxoy.com`或`RECAPTCHA_PROXY_URL=http://127.0.0.1:7022`)\n\n3. 重启`genspark2api`服务。\n\n#### 接入自定义Recaptcha服务\n\n###### 接口：获取令牌\n\n###### 基本信息\n\n- **接口地址**：`/genspark`\n- **请求方式**：GET\n- **接口描述**：获取用户认证令牌\n\n###### 请求参数\n\n###### 请求头\n\n| 参数名    | 必选 | 类型     | 说明     |\n|--------|----|--------|--------|\n| cookie | 是  | string | 用户会话凭证 |\n\n###### 响应参数\n\n###### 响应示例\n\n```json\n{\n  \"code\": 200,\n  \"token\": \"ey********pe\"\n}\n```\n\n## 报错排查\n\n\u003e `Detected Cloudflare Challenge Page`\n\u003e\n\n被Cloudflare拦截出5s盾,可配置`PROXY_URL`。\n\n(【推荐方案】[自建ipv6代理池绕过cf对ip的速率限制及5s盾](https://linux.do/t/topic/367413)\n或购买[IProyal](https://iproyal.cn/?r=244330))\n\n\u003e `Genspark Service Unavailable`\n\u003e\nGenspark官方服务不可用,请稍后再试。\n\n\u003e `All cookies are temporarily unavailable.`\n\u003e\n所有用户(cookie)均到达速率限制,更换用户cookie或稍后再试。\n\n## 生视频请求格式\n\n### Request\n\n**Endpoint**: `POST /v1/videos/generations`\n\n**Content-Type**: `application/json`\n\n#### Request Parameters\n\n| 字段 Field     | 类型 Type | 必填 Required | 描述 Description            | 可选值 Accepted Values                                                                             |\n|--------------|---------|-------------|---------------------------|-------------------------------------------------------------------------------------------------|\n| model        | string  | 是           | 使用的视频生成模型                 | 模型列表: `sora-2`\\|`sora-2-pro`\\|`gemini/veo3`\\|`gemini/veo3/fast`\\|`kling/v2.5-turbo/pro`\\|`fal-ai/bytedance/seedance/v1/pro`\\|`minimax/hailuo-02/standard`\\|`pixverse/v5`\\|`fal-ai/bytedance/seedance/v1/lite`\\|`gemini/veo2`\\|`wan/v2.2`\\|`hunyuan`\\|`vidu/start-end-to-video`\\|`runway/gen4_turbo` |\n| aspect_ratio | string  | 是           | 视频宽高比                     | `9:16` \\| `16:9` \\| `3:4` \\|`1:1` \\| `4:3`                                                      |\n| duration     | int     | 是           | 视频时长（单位：秒）                | 正整数                                                                                             |\n| prompt       | string  | 是           | 生成视频的文本描述                 | -                                                                                               |\n| auto_prompt  | bool    | 是           | 是否自动优化提示词                 | `true` \\| `false`                                                                               |\n| image        | string  | 否           | 用于视频生成的基底图片（Base64编码/url） | Base64字符串/url                                                                                   |\n\n---\n\n### Response\n\n#### Response Object\n\n```json\n{\n  \"created\": 1677664796,\n  \"data\": [\n    {\n      \"url\": \"https://example.com/video.mp4\"\n    }\n  ]\n}\n```\n\n## 其他\n\n**Genspark**(\n注册领取1个月Plus): [https://www.genspark.ai](https://www.genspark.ai/invite?invite_code=YjVjMGRkYWVMZmE4YUw5MDc0TDM1ODlMZDYwMzQ4OTJlNmEx)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeanxv%2Fgenspark2api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeanxv%2Fgenspark2api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeanxv%2Fgenspark2api/lists"}