Introdução geral
genspark2api 是一个开源的 API 服务工具,托管在 GitHub 上,由开发者 deanxv 创建。它提供了一个支持多模型对话、文生图和文生视频的接口服务,用户可以通过 Docker 快速部署在本地或服务器上。这个工具的核心功能是让开发者轻松调用多种对话模型(如 gpt-4o、claude-3-5-sonnet)和生成工具(如 flux、dall-e-3),支持联网搜索和图片识别等多轮对话。项目版本目前为 3.4,代码完全公开,用户可以自由修改。它的设计目标是简化开发流程,适合技术爱好者或小型团队使用。
Lista de funções
- 支持多种对话模型接口(流式和非流式),如
gpt-4o
eclaude-3-5-sonnet
,未支持模型会自动切换到 Mixture-of-Agents 模式。 - 提供联网搜索功能,在模型名后加
-search
即可使用,例如gpt-4o-search
. - 支持图片和文件识别的多轮对话,用户可以上传内容进行交互。
- 提供文生图接口
/images/generations
,支持模型如fluxo
edall-e-3
. - 支持文生视频和图生视频接口
/videos/generations
,可用模型包括kling/v1.6/standard
. - 通过 cookie 池和自动重试机制提升服务稳定性。
- 支持自定义接口密钥(
API_SECRET
)和代理配置(PROXY_URL
). - 允许绑定模型和对话,防止模型切换导致响应质量下降。
Usando a Ajuda
Processo de instalação
genspark2api 依赖 Docker 部署,适合有基础技术能力的用户。以下是详细步骤:
- Instalando o Docker
在电脑或服务器上安装 Docker。访问https://www.docker.com/
下载并安装。安装后运行以下命令确认:
docker --versão
如果显示版本号,说明环境就绪。
- Puxando espelhos
在终端输入命令拉取最新镜像:
docker pull deanxv/genspark2api:latest
如果拉取失败,可用 GitHub 镜像:
docker pull ghcr.io/deanxv/genspark2api:latest
- Configuração de variáveis de ambiente
创建一个本地文件夹(如. /data
)存储数据。准备以下变量:
GS_COOKIE
: De genspark 官网获取的 cookie,多个用逗号分隔。API_SECRET
:自定义密钥,如 "123456",用于接口安全校验。TZ
:时区,如 "Asia/Shanghai"。
示例运行命令:
docker run --name genspark2api -d --restart always
-p 7055:7055
-v ./data:/app/genspark2api/data
-e GS_COOKIE="session_id=你的cookie"
-e API_SECRET="123456"
-e TZ="Asia/Shanghai"
deanxv/genspark2api:latest
- 启动并验证
运行后,访问http://localhost:7055
检查服务状态。如果需要查看日志:
docker logs genspark2api
获取 cookie
- 打开浏览器,按 F12 进入开发者工具。
- entrevistas
https://www.genspark.ai
,发起一次对话。 - 在“网络”选项卡中找到
perguntar
请求,复制请求头中的cookie
值。
必须包含session_id=xxx
As outras partes são opcionais.
Usando a interface de diálogo
O caminho da interface de diálogo é /chat/completions
O sistema de controle de qualidade, que suporta saídas de streaming e não streaming.
- Exemplo de uma solicitação(sem streaming):
curl -X POST http://localhost:7055/chat/completions
-H "Autorização: Portador 123456"
-H "Content-Type: application/json"
-d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "hello"}]}'
- saída de streaming: Adicionar
"stream": true
Os dados são retornados em blocos. - Retornar ao exemplo::
{"choices": [{"message": {"role": "assistant", "content": "Hello! Como posso ajudá-lo?"}}]}
Usando a interface Vincennes
O caminho é /images/generations
suporte para geração de imagens.
- Exemplo de uma solicitação::
curl -X POST http://localhost:7055/images/generations
-H "Autorização: Portador 123456"
-H "Content-Type: application/json"
-d '{"model": "flux", "prompt": "A cat playing in the grass"}'
- Retornar ao exemplo::
{"data": [{"url": "https://example.com/image.jpg"}]}
Usando a interface de vídeo Vincent
O caminho é /videos/generations
O sistema de vídeo da Microsoft, que suporta texto ou imagem para gerar vídeo.
- Exemplo de uma solicitação(geração de texto):
curl -X POST http://localhost:7055/videos/generations
-H "Autorização: Portador 123456"
-H "Content-Type: application/json"
-d '{"model": "kling/v1.6/standard", "prompt": "city_night", "aspect_ratio": "16:9", "duration": 10, "auto_prompt": true}'
- Retornar ao exemplo::
{"created": 1677664796, "data": [{"url": "https://example.com/video.mp4"}]}
Configuração da autenticação ReCaptcha
A verificação pelo ReCaptchaV3 é oficialmente exigida, caso contrário, o modelo poderá ter sua inteligência reduzida ou gerar anomalias. É necessário trabalhar com genspark-playwright-proxy
Serviços:
- Implantação de serviços de proxy:
docker run --name genspark-playwright-proxy -d --restart always
-p 7022:7022
-v . /data:/app/genspark-playwright-proxy/data
-e TZ="Ásia/Shanghai"
deanxv/genspark-playwright-proxy:latest
- Adicione variáveis de ambiente ao genspark2api:
-e RECAPTCHA_PROXY_URL="http://127.0.0.1:7022"
- Reinicie o serviço para que ele entre em vigor.
Perguntas frequentes
- retorna "Todos os cookies estão temporariamente indisponíveis".
Todos os cookies atingiram o limite de taxa. Substitua por um novoGS_COOKIE
Ou esperar um pouco. - Encontrando interceptações da Cloudflare
configurarPROXY_URL
Por exemplo-e PROXY_URL="http://127.0.0.1:10801"
.
cenário do aplicativo
- Desenvolvimento de um atendimento inteligente ao cliente
Crie rapidamente bots de atendimento ao cliente por meio de interfaces de diálogo que suportam pesquisas em rede e várias rodadas de diálogo para responder às perguntas dos clientes. - Gerar conteúdo criativo
Use os recursos de texto para gráficos e texto para vídeo para inserir descrições e gerar imagens ou vídeos curtos para uso em protótipos de design ou conteúdo de mídia social. - Educação e aprendizado tecnológico
Os alunos ou desenvolvedores podem implementar serviços, chamar diferentes modelos para experimentos e aprender sobre APIs e integração de modelos.
QA
- Quais modelos de diálogo são suportados?
apoiar algogpt-4o
eclaude-3-5-sonnet
Há uma variedade de modelos, como o modelo Mixture-of-Agents, e os modelos não listados acionam o modo Mixture-of-Agents. - O que devo fazer se o gráfico vicentino falhar?
sondaRECAPTCHA_PROXY_URL
Ele está configurado corretamente para garantir que seja aprovado na validação do ReCaptchaV3? - Como melhorar a estabilidade do serviço?
Configurar váriosGS_COOKIE
Se você quiser ativar o pooling de cookies, poderá alternar automaticamente quando uma solicitação falhar.