双子座 2.5 游乐场

Gemini 2.5 PlayGround

英文版

作者：技术爬爬虾

B站、YouTube、抖音、公众号 全网同名。转载请注明作者。

项目简介

演示链接：https://play.210718.xyz

只需准备一个Gemini API Key，10秒即可部署一个Gemini多模态对话的网站。 不限地区/网络环境，打开即用，适配了手机端。 使用Deno/Cloudflare Worker无服务器免费部署。 对Gemini Chat API 进行了格式转换，中转为更通用的OpenAI格式，国内直连可用。 可对接AI编程，接入ChatBox等AI客户端。

Deno部署（推荐）

0. 准备一个Gemini API Key https://aistudio.google.com（免费）
1. fork本项目
2. 登录/注册 https://dash.deno.com/
3. 创建项目 https://dash.deno.com/new_project
4. 选择此项目，填写项目名字（请仔细填写项目名字，关系到自动分配的域名）
5. Entrypoint 填写 src/deno_index.ts 其他字段留空
   如图

   
6. 点击 Deploy Project
7. 部署成功后获得域名，点开即用。域名同样可以作为Chat API的代理使用。

Cloudflare Worker 部署

0. 准备一个Gemini API Key https://aistudio.google.com（免费）
1. 点击部署按钮
2. 登录Cloudflare账号
3. 填入Account ID，与API Token
4. Fork本项目，开启Github Action功能
5. 部署，打开dash.cloudflare.com，查看部署后的worker
6. 国内使用需要绑定一个自定义域名
   如图

   

国内使用cloudflare有时候可能出现400: User location is not supported for the API use. 可能是粤港地区Cloudflare路由到了香港的CDN节点代理导致的。建议换成Deno部署。

本地调试

Windows 安装Deno:

irm https://deno.land/install.ps1 | iex

Mac/Linux 安装Deno:

curl -fsSL https://deno.land/install.sh | sh

启动项目：

cd 项目目录
deno run --allow-net --allow-read src/deno_index.ts

使用方法

多模态对话

填入API Key, 点击Connect按钮即可对话。 以下三个按钮分别是：

• 启用麦克风
• 启用摄像头
• 分享屏幕

如图

API 代理

API已经被代理为OpenAI格式，可以直接使用OpenAI格式的API。 不限网络环境，可免梯子使用。 注意替换域名与Gemini API Key。

可用模型列表：

curl --location 'http://your.domain.com/v1/models' \
--header 'Authorization: Bearer YOUR-GEMINI-API-KEY'

对话:

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.5-flash"
}'

ChatBOX：

如图

Cursor编程：

如图

致谢/引用：

网站UI：

Author: ChrisKyle
Project: https://github.com/ViaAnthroposBenevolentia/gemini-2-live-api-demo
MIT License : https://github.com/ViaAnthroposBenevolentia/gemini-2-live-api-demo/blob/main/LICENSE

Gemini转成OpenAI格式：

Author: PublicAffairs
Project: https://github.com/PublicAffairs/openai-gemini
MIT License : https://github.com/PublicAffairs/openai-gemini/blob/main/LICENSE

Gemini 2.5 PlayGround 快速上手指南

环境准备

系统要求

• 支持 Windows、macOS、Linux 系统
• 需要网络环境（可访问 Google AI Studio）

前置依赖

• Deno（用于 Deno 部署）
• Cloudflare Worker（用于 Cloudflare 部署）
• GitHub 账号（用于 Fork 项目和 GitHub Action）
• Gemini API Key（免费获取）

安装步骤

通过 Deno 部署（推荐）

1. Fork 项目：https://github.com/tech-shrimp/gemini-playground/fork
2. 登录 Deno Dashboard
3. 创建新项目，填写项目名称
4. 设置入口文件为 src/deno_index.ts
5. 点击 Deploy Project 进行部署
6. 部署完成后获得域名，即可使用

通过 Cloudflare Worker 部署

1. 点击 Deploy to Cloudflare Workers
2. 登录 Cloudflare 账号
3. 填写 Account ID 和 API Token
4. Fork 项目并开启 GitHub Action
5. 部署后在 dash.cloudflare.com 查看 Worker
6. 国内用户需绑定自定义域名

基本使用

多模态对话

1. 在网页中填入你的 Gemini API Key
2. 点击 Connect 按钮开始对话
3. 使用以下功能：
   • 启用麦克风
   • 启用摄像头
   • 分享屏幕

API 代理

将 API 代理为 OpenAI 格式，可直接使用：

获取可用模型列表

curl --location 'http://your.domain.com/v1/models' \
--header 'Authorization: Bearer YOUR-GEMINI-API-KEY'

发起对话请求

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.5-flash"
}'