SophieTwilight's Gemini API

🚀 快速上手

【严重警告：请务必关闭客户端代理功能】
本服务无需开启网络兼容性使用，强烈建议关闭您客户端（如Chatbox）中的“改善网络兼容性”、“使用代理”或任何类似功能。
开启这些功能通常没有任何帮助，反而有可能会影响您的使用体验（高延迟、连接中断、发送请求无响应），并且可能因触发服务器的同IP速率限制而导致您的访问被临时封禁。

在任何兼容 OpenAI 的客户端或代码中，填入以下信息即可开始使用：

API 地址 (Base URL): https://www.sophietwilight.com/gemini-api
模型 (Model):
gemini-2.5-pro（关闭流式传输）
gemini-2.5-pro-streaming（开启流式传输）
gemini-2.5-pro-think（开启思考链）
gemini-2.5-pro-think-streaming（开启流式传输+思考链）
gemini-2.5-pro-streaming-openai（开启流式传输+使用openai兼容通道）
API 密钥 (API Key): 请填写您自己的API密钥或留空

重要提示：使用免费测试的模型时，可以将 API Key 留空，这样会自动启用内置的免费密钥池。当前免费模型仅提供gemini-2.5-pro服务。由于这个配置是为了适配CHATBOX而存在，虽然它理论上兼容各种客户端，但并不支持非流式请求。所以切换流式传输是通过更改模型名称来实现的，无论你是否需要开启流式传输，你的前端本身都必须打开流式传输功能。（CHATBOX是默认开启的）

核心功能

⏳ 关闭流式: 即使使用chatbox也可以用伪流来关闭流式传输，以避免Gemini莫名其妙的夹断和二审。（见鬼了，让它扮演赛博鼠子想摸摸毛也会夹断，用API玩宝可梦也会夹断。）
🌐 联网搜索: 启用Gemini自带的联网搜索功能
🧠 查看思考链: 通过前置的消息和预设提示词来呈现Gemini思考链，已经调整为中文思考链。（并不稳定）
✨ 试用模型: 无自备API的情况下，可以尝试使用 gemini-2.5-pro 模型完全免费，服务通过内置密钥池自动轮换，为您提供并不稳定的免费服务。
🔌 高度兼容: 完美适配所有支持 OpenAI API 格式的软件和库（如 NextChat, LobeChat, Ama, Open-WebUI 等）。（Gemini是如此自称的，但我也不清楚）
🔓 安全无限制（自欺欺人版）: 所有安全审查选项 (HARM_CATEGORY_*) 均已设置为 BLOCK_NONE，在 Google 的政策框架下，为您提供最大程度的创作自由。（不影响二审，该二审夹断的还是夹断）
🖼️ 多模态支持: 完整支持 Gemini 的多模态能力，您可以轻松上传图片进行视觉分析（需您的客户端支持该功能）。

🔮 独家特殊功能

本服务不仅是简单的中转，更通过脚本注入了多项独家增强功能：

1. 模型后缀（Model Suffixes）

通过在模型名称后添加特定后缀，可以激活不同功能模式：

-think: 实时思考模式
激活后，模型在回答前会先输出一段被 thought 标签包裹的中文思考过程。这让你能“看到”AI 的思路，非常适合调试 Prompt 和观察模型行为。（以及角色扮演）
示例模型: gemini-2.5-pro-think
-streaming: 真·流式响应
默认情况下，为保证Chatbox可关闭流式以及稳定性，服务采用“伪流式”一次性返回结果。添加此后缀可切换为来自 Google 的原生服务器推送事件（SSE），实现真正的逐字流式响应，延迟更低。
示例模型: gemini-2.5-pro-streaming
-openai: OpenAI 兼容通道
为应对原生通道可能出现的故障（如莫名截断、卡顿），此后缀会激活一个备用的 OpenAI 兼容通道。此方案有助于缓解问题，但并非根治。
重要限制：使用此通道时，【联网搜索】功能将无法生效。
示例模型: gemini-2.5-pro-openai

后缀可以组合使用，例如 gemini-2.5-pro-think-streaming 可以同时开启思考和真流式模式。-openai 后缀也可以与其他后缀（如 -think）结合使用。

2. 系统指令（System Prompt Directives）

在客户端的“系统提示(System Prompt)”中，通过特定格式的命令，可以对模型进行更精细的控制：

用户称呼=你的昵称: 自定义 AI 在思考过程中对你的称呼，开启思考链显示可用。
示例: 用户称呼=博士
用户提示=你的提示内容: 在用户的最新一轮消息后追加一条隐藏提示，用于临时强化或引导模型。
示例: 用户提示=请在你的回答中多使用比喻手法。
思考预算=级别: 控制 -think 模式下的思考计算量，数字越大思考越深入（也可能越慢）。当前pro模型使用可能会导致内部错误，这是Gemini自身问题需要等待官方修复，所以目前不建议使用该功能。
有效级别: -1 (动态), 0 (关闭), 1 (极低) 至 10 (最大)。
示例: 思考预算=5

3. 联网搜索

模型具备执行 Google 搜索以获取最新信息的能力。当需要模型联网查询时，只需在你的问题中包含关键词 【联网搜索】 即可自动触发。请注意，当使用包含 -openai 后缀的模型时，此功能将不可用。

示例: “2024年欧洲杯的冠军是哪支队伍？【联网搜索】”

⚙️ 模型支持

免费模型:
- gemini-2.5-pro (以及其后缀组合)
使用自有 API Key:
如果您拥有自己的 Google AI API 密钥，也可以通过本中转服务使用其他 Gemini 模型。只需在客户端的 API Key 处填写您自己的密钥，并选择相应的模型名称即可。支持包括：
- gemini-2.5-pro
- gemini-2.5-flash
- 以及其他您拥有访问权限的 Gemini 模型。

📜 代码示例

cURL 请求 (使用免费模型)

curl -X POST \
  'https://www.sophietwilight.com/gemini-api/v1/chat/completions' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gemini-2.5-pro-think",
    "messages": [
      {
        "role": "system",
        "content": "你是一个乐于助人的AI助手。\n思考预算=4"
      },
      {
        "role": "user",
        "content": "你好，请介绍一下你自己。"
      }
    ],
    "stream": true
  }'

Python 请求 (使用 openai 库)

import openai

# 使用免费模型时，api_key 必须留空或设为 None
client = openai.OpenAI(
    api_key=None,
    base_url="https://www.sophietwilight.com/gemini-api/v1" # 注意 v1 在这里
)

response = client.chat.completions.create(
    model="gemini-2.5-pro",
    messages=[
        {"role": "system", "content": "你是一个乐于助人的AI助手。"},
        {"role": "user", "content": "你好，请介绍一下你自己。"}
    ]
)

print(response.choices[0].message.content)

⚠️ 使用须知

本服务为纯公益项目，旨在技术分享和学习交流，请勿用于任何商业或非法用途。
点击此处下载提供服务的源代码
点击此处可以进入Gemini深度思考的网页。此为早期使用的思考暴露前端。
这是提供给Gemini爱好群的共享服务，请勿广为传播，请不要发送任何私人、敏感或机密信息。
为保证服务的公平和稳定，请避免高频或自动化的滥用行为。我们希望建立一个互相尊重的社区环境，让更多人能享受到这项服务。
我们仅记录最少的必要日志以供调试，不会存储您的对话内容。
使用最垃圾的包月服务器，无法保证高负载正常运作。
使用者应对其所有输入内容及通过本服务生成的输出内容自行承担全部责任。
请自觉遵守您所在地区、服务提供地及数据源（Google）的相关法律法规和政策。严禁利用本服务进行任何违法违规活动。
所有AI生成内容均由上游模型提供，其观点与本站立场无关，我们不对其准确性、完整性或合法性做出任何保证。
您理解并同意，使用本服务所产生的一切风险由您自行承担。在任何情况下，服务提供者均不对因使用或无法使用本服务而导致的任何损害负责。