中文
> ⚠️目前官方强制校验`ReCaptchaV3` > 不通过则模型降智/生图异常,请参考[genspark-playwright-prxoy服务过V3验证](#genspark-playwright-prxoy服务过V3验证)并配置环境变量 `RECAPTCHA_PROXY_URL`。 ## 功能 - [x] 支持对话接口(流式/非流式)(`/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** - [x] 支持**联网搜索**,在模型名后添加`-search`即可(如:`gpt-4o-search`) - [x] 支持识别**图片**/**文件**多轮对话 - [x] 支持文生图接口(`/images/generations`) - **fal-ai/nano-banana** - **fal-ai/bytedance/seedream/v4** - **gpt-image-1** - **flux-pro/ultra** - **flux-pro/kontext/pro** - **imagen4** - [x] 支持文/图生视频接口(`/videos/generations`),详情查看[文/图生视频请求格式](#生视频请求格式) - [x] 支持自定义请求头校验值(Authorization) - [x] 支持cookie池(随机) - [x] 支持请求失败自动切换cookie重试(需配置cookie池) - [x] 可配置自动删除对话记录 - [x] 可配置代理请求(环境变量`PROXY_URL`) - [x] 可配置Model绑定Chat(解决模型自动切换导致**降智**),详细请看[进阶配置](#解决模型自动切换导致降智问题)。 ### 接口文档: 略 ### 示例:
## 如何使用
略
## 如何集成NextChat
填 接口地址(ip:端口/域名) 及 API-Key(`PROXY_SECRET`),其它的随便填随便选。
> 如果自己没有搭建NextChat面板,这里有个已经搭建好的可以使用 [NeatChat](https://ai.aytsao.cn/)
## 如何集成one-api
填 `BaseURL`(ip:端口/域名) 及 密钥(`PROXY_SECRET`),其它的随便填随便选。
## 部署
### 基于 Docker-Compose(All In One) 进行部署
```shell
docker-compose pull && docker-compose up -d
```
#### docker-compose.yml
```docker
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
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`即可。
### 部署到第三方平台