Gemini 兼容接口
Google Gemini 的两种调用形式(原生
generateContent与 OpenAI 兼容)都能走 FluxToken。
端点与模型名
Gemini 系模型走与另外两种协议相同的端点,只是路径和模型名不同:
可用的 Gemini 模型一共三个(对话类):
| 模型名 | 定位 |
|---|---|
gemini-3.1-pro | 能力强,适合复杂任务 |
gemini-3.7-flash | 速度快 |
gemini-3.8-flash | 速度快 |
对应的分组是 【Gemini】Pro · 企业级(倍率 0.3,官方说明:采用 Gemini Pro 企业级池子稳定性一流)。 生图模型在另一个分组,见下。
两种接法
Gemini 兼容有两条路,选一条就行:
| 接法 | 基础地址 | 路径形态 | 适合 |
|---|---|---|---|
| 原生 Gemini 格式 | https://cn.fluxtoken.ai | /v1beta/models/<模型>:generateContent | Gemini SDK、Cline、Roo Code |
| OpenAI 兼容格式 | https://cn.fluxtoken.ai/v1 | /chat/completions | 已有 OpenAI 代码,不想改 SDK |
原生格式不需要你补 /v1,路径里就是 v1beta。
原生 Gemini 格式
curl https://cn.fluxtoken.ai/v1beta/models/gemini-3.1-pro:generateContent \ -H "x-goog-api-key: sk-你的令牌" \ -H "Content-Type: application/json" \ -d "{\"contents\":[{\"parts\":[{\"text\":\"用一句话介绍你自己\"}]}]}"curl https://cn.fluxtoken.ai/v1beta/models/gemini-3.1-pro:streamGenerateContent \ -H "x-goog-api-key: sk-你的令牌" \ -H "Content-Type: application/json" \ -d "{\"contents\":[{\"parts\":[{\"text\":\"数到十\"}]}]}"鉴权三种请求头都接受:x-goog-api-key、Authorization: Bearer、x-api-key。 未鉴权时返回 401,响应体是 Gemini 风格:
{
"error": {
"code": 401,
"message": "API key is required",
"status": "UNAUTHENTICATED"
}
}令牌无效时 message 变成 Invalid API key,status 仍是 UNAUTHENTICATED。
from google import genaiclient = genai.Client( api_key="sk-你的令牌", http_options={"base_url": "https://cn.fluxtoken.ai"},)resp = client.models.generate_content( model="gemini-3.1-pro", contents="你好",)print(resp.text)SDK 参数名随版本变
google-genai 这个包在不同大版本里配置 base_url 的写法改过。 如果上面的写法在你的版本里报参数错误,查一下你所装版本的官方文档 —— 要填的值始终是 https://cn.fluxtoken.ai,不带 /v1。
OpenAI 兼容格式调 Gemini
如果不方便换 SDK,把 Gemini 模型当普通模型调即可:
curl https://cn.fluxtoken.ai/v1/chat/completions \ -H "Authorization: Bearer sk-你的令牌" \ -H "Content-Type: application/json" \ -d "{\"model\":\"gemini-3.1-pro\",\"messages\":[{\"role\":\"user\",\"content\":\"你好\"}]}"from openai import OpenAIclient = OpenAI( api_key="sk-你的令牌", base_url="https://cn.fluxtoken.ai/v1",)resp = client.chat.completions.create( model="gemini-3.1-pro", messages=[{"role": "user", "content": "你好"}],)print(resp.choices[0].message.content)模型名与分组必须对上
调用 Gemini 模型时,令牌的分组决定了你能用哪几个:
| 你想用的模型 | 令牌分组要选 |
|---|---|
gemini-3.1-pro、gemini-3.7-flash、gemini-3.8-flash | 【Gemini】Pro · 企业级 |
gemini-3-pro-image-preview、gemini-3.1-flash-image-preview | 【Gemini】banana生图模型 |
分组不对,返回的是 模型不存在。排查步骤见模型不存在。
采用 Gemini Pro 企业级池子稳定性一流。
- 模型数
- 3
- 输入价起
- $0.225 /1M
- 上游
查看该组全部模型(3)
gemini-3.1-pro$0.6 / $3.6gemini-3.7-flash$0.225 / $1.125gemini-3.8-flash$0.225 / $1.125
暂无说明。
- 模型数
- 2
- 输入价起
- $— /1M
- 上游
查看该组全部模型(2)
gemini-3-pro-image-preview$— / $—gemini-3.1-flash-image-preview$— / $—
关于 Gemini CLI
本站不提供 Google 官方 Gemini CLI 的配置教程。 原因是官方 CLI 在当前渠道上的稳定性不足, 写一份随时会失效的教程对用户没帮助。
推荐用支持 Gemini 的图形/编辑器客户端代替:
- Cline —— VS Code 插件,支持 Gemini 协议
- Roo Code —— 同类,按自己的使用习惯选
- Cherry Studio —— 用 OpenAI 兼容模式
统一配 【Gemini】Pro · 企业级 分组。细节见Gemini 专题。