综合介绍
Gemini Playground 是一个开源项目,旨在帮助用户快速部署一个多模态对话网站。该项目由技术爬爬虾开发,支持使用 Gemini API Key 在 10 秒内完成部署。无论用户身处何地,均可通过 Deno 或 Cloudflare Worker 进行无服务器部署,且适配手机端使用。项目将 Gemini Chat API 转换为更通用的 OpenAI 格式,使其在国内也能直接使用。用户可以将其集成到 AI 编程、ChatBox 等 AI 客户端中,提供便捷的多模态对话体验。
功能列表
- 快速部署:只需 10 秒即可完成多模态对话网站的部署。
- 无服务器部署:支持 Deno 和 Cloudflare Worker 部署方式。
- 多模态对话:支持文本、语音、视频等多种对话形式。
- API 代理:将 Gemini Chat API 转换为 OpenAI 格式,方便国内用户使用。
- 移动端适配:适配手机端,随时随地进行对话。
- AI 编程集成:可与 ChatBox 等 AI 客户端集成,支持 AI 编程。
使用帮助
安装流程
Deno 部署(推荐)
- 准备一个 Gemini API Key(可免费获取)。
- Fork 本项目。
- 登录或注册 Deno 账号。
- 创建新项目,选择本项目并填写项目名称(项目名称将影响自动分配的域名)。
- 在 Entrypoint 字段填写
src/deno_index.ts
,其他字段留空。 - 点击 "Deploy Project" 按钮,部署成功后将获得域名,打开即用。
Cloudflare Worker 部署
- 准备一个 Gemini API Key(可免费获取)。
- 点击部署按钮,登录 Cloudflare 账号。
- 填入 Account ID 和 API Token。
- Fork 本项目并开启 Github Action 功能。
- 部署完成后,打开 Cloudflare Dashboard 查看部署的 Worker。
- 国内使用需绑定自定义域名,建议使用 Deno 部署以避免路由问题。
使用方法
- 多模态对话:在网站中填入 API Key,点击 "Connect" 按钮即可开始对话。支持启用麦克风、摄像头和分享屏幕。
- API 代理:API 已被代理为 OpenAI 格式,用户可直接使用 OpenAI 格式的 API。替换域名和 Gemini API Key 后即可使用。
- 获取可用模型列表:
bash
curl --location 'http://your.domain.com/v1/models' \
--header 'Authorization: Bearer YOUR-GEMINI-API-KEY'
- 进行对话:
bash
curl --location 'https://your.domain.com/v1/chat/completions' \
--header 'Authorization: Bearer YOUR-GEMINI-API-KEY' \
--header 'Content-Type: application/json' \
--data '{
"messages": [
{ "role": "system", "content": "You are a test assistant." },
{ "role": "user", "content": "Testing. Just say hi and nothing else." }
],
"model": "gemini-2.0-flash-exp"
}'
- 获取可用模型列表: