国内开发者怎么调用 Gemini API？

在代码里只改两处：base_url 填 https://api.relayswitch.io/v1，api_key 填本站的 sk-relay- 密钥，model 写 Gemini 的 id（例如 gemini-4-argon），用 OpenAI SDK 的 Chat Completions 调用。账户用邮箱开通，USDT 或银行卡充值，最低 $10。本站只提供 API 和计费，不提供网络接入服务。

需要 Google 账号或 AI Studio 的密钥吗？

不需要。Google 自己的 Gemini API 要用 Google 账号在 AI Studio 里创建密钥；这里的账户开在本站，一个邮箱即可，密钥在本站控制台创建，同一把密钥还能调用目录里的其他模型。

用 OpenAI SDK 还是 Gemini 原生格式？

新写的程序用 OpenAI SDK，改 base_url 就行，换别家的模型也只改 model 一个字段。已经按 Google 的 generateContent 写好的程序，可以把请求发到本站的 /v1beta/models/{model}:generateContent 路由，密钥放在 x-goog-api-key 头里。两种格式用同一把密钥、同一个余额，价格相同。

Gemini API 中转的价格和官方比怎么样？

以 Gemini 4 Argon 为例：本站输入 $0.60、输出 $3.00，Google 公布的标价是 $2.00 和 $10.00，单位都是美元 / 百万 tokens。没有倍率，表里的价格就是扣减价；每个型号的对照在上面的价格表，渲染时读取。

Gemini 有免费额度吗？

Google 自己的 Gemini API 对部分模型有带速率限制的免费层，哪些模型在内以它的价格页为准。本站没有免费层：每次请求按 token 从预付余额扣减，充值最低 $10，余额不过期。

怎么确认调用的是真的 Gemini？

每个模型每天收到同一条检测提示，答案与之前比对，结果公开在 https://api.relayswitch.io/v1/proof（今日 312 / 336 个模型稳定），不用密钥就能查。每次请求还有一张签名回执（GET https://api.relayswitch.io/v1/requests/:id/receipt），写明模型 id、计费 tokens 和费用。

Gemini · 核对于 2026-11-11

Gemini API 中转

国内开发者接入 Gemini API，用的是 OpenAI 兼容格式：base_url 填 https://api.relayswitch.io/v1，密钥换成本站的，model 写 Gemini 的 id，OpenAI SDK 原样可用。19 个 Gemini 模型 id，价格读取自实时目录，无倍率，每天公开验真。邮箱开通，USDT 或银行卡充值。

获取密钥文档

Base URLhttps://api.relayswitch.io/v1

鉴权头Authorization: Bearer <key>

模型 id"model": "gemini-4-argon"

Gemini API 中转是什么

直接用 Gemini API，要有 Google 账号，在 AI Studio 里创建密钥，再按 Google 的计费方式付款。中转把这一段换掉：你向中转站预付，拿中转站的密钥，请求发到中转站的网关，由网关送到 Gemini。对代码来说变的只有地址和密钥，模型还是 gemini-4-argon 这样的 id。

Gemini 有自己的请求格式（generateContent），但多数现成的工具和代码是按 OpenAI 的 Chat Completions 写的。Google 自己也为此提供了一层 OpenAI 兼容接口，并在文档里注明这项支持仍是 beta。本站的做法相同：下面价格表里的每个 Gemini id 都可以用 OpenAI 格式调用，所以把一段已有的 OpenAI 代码换成 Gemini，只需要改 model 一个字段。

计费按 token：输入、缓存输入、输出三个单价，下表就是扣减价，没有倍率、分组或充值汇率。模型是不是标签上那个，每天有一次公开检测，结果在真实模型验证。

Gemini 模型实时价格

美元 / 百万 tokens，渲染时读取自目录；人民币为参考价（ECB 2026-11-11 汇率），计费以美元为准。

模型	输入	缓存输入	输出	官方价输入 / 输出	相当于官方价	上下文	输入类型
Gemini 4 Argongemini-4-argon	$0.60≈ ¥4.08	$0.06≈ ¥0.408	$3.00≈ ¥20.41	$2.00 / $10.00	3 折	1M	文本、图片、音频、视频
Gemini 3.8 Flashgemini-3.8-flash	$0.4925≈ ¥3.35	$0.0493≈ ¥0.335	$2.25≈ ¥15.31	$0.75 / $3.75	输入 6.6 折 · 输出 6 折	1M	文本、图片、音频、视频
Gemini 3.7 Flashgemini-3.7-flash	$0.4925≈ ¥3.35	$0.0493≈ ¥0.335	$2.25≈ ¥15.31	$0.75 / $3.75	输入 6.6 折 · 输出 6.1 折	1M	文本、图片、音频、视频
Gemini 3.5 Flash Litegemini-3.5-flash-lite	$0.225≈ ¥1.53	$0.0225≈ ¥0.153	$1.875≈ ¥12.76	$0.30 / $2.50	7.5 折	1M	文本、图片、音频、视频
Gemini 3.6 Flashgemini-3.6-flash	$0.4925≈ ¥3.35	$0.0492≈ ¥0.335	$2.25≈ ¥15.31	$0.75 / $3.75	输入 6.6 折 · 输出 6.1 折	1M	文本、图片、音频、视频
Gemini 3.5 Flashgemini-3.5-flash	$1.50≈ ¥10.21	$0.15≈ ¥1.02	$9.00≈ ¥61.24	$1.50 / $9.00	同官方价	1M	文本、图片、音频、视频
Gemini 3.1 Flash Lite Previewgemini-3.1-flash-lite-preview	$0.1875≈ ¥1.28	$0.0188≈ ¥0.128	$1.125≈ ¥7.65	$0.25 / $1.50	7.5 折	1M	文本、图片、音频、视频
Gemini 3.1 Pro Previewgemini-3.1-pro-preview	$1.20≈ ¥8.16	$0.12≈ ¥0.816	$7.20≈ ¥48.99	$2.00 / $12.00	6 折	1M	文本、图片、音频、视频
Gemini 3 Flash Previewgemini-3-flash-preview	$0.375≈ ¥2.55	$0.0375≈ ¥0.255	$2.25≈ ¥15.31	$0.50 / $3.00	7.5 折	1M	文本、图片、音频、视频
Gemini 2.5 Flashgemini-2.5-flash	$0.30≈ ¥2.04	$0.03≈ ¥0.204	$2.50≈ ¥17.01	$0.30 / $2.50	同官方价	1M	文本、图片、音频、视频
Gemini 2.5 Progemini-2.5-pro	$0.9375≈ ¥6.38	$0.0938≈ ¥0.638	$7.50≈ ¥51.03	$1.25 / $10.00	7.5 折	1M	文本、图片、音频、视频
Gemini 2.5 Flash Litegemini-2.5-flash-lite	$0.075≈ ¥0.51	$0.06≈ ¥0.408	$0.30≈ ¥2.04	$0.10 / $0.40	7.5 折	—	—
Gemini 3.1 Flash Litegemini-3.1-flash-lite	$0.15≈ ¥1.02	$0.15≈ ¥1.02	$0.90≈ ¥6.12	$0.25 / $1.50	6 折	—	—
Gemini 3.1 Progemini-3.1-pro	$0.60≈ ¥4.08	$0.06≈ ¥0.408	$3.60≈ ¥24.49	$2.00 / $12.00	3 折	—	—
Gemini 3.1 PRO Preview Customtoolsgemini-3.1-pro-preview-customtools	$4.80≈ ¥32.66	$0.48≈ ¥3.27	$28.80≈ ¥195.96	—	—	1M	—
Gemini 4 Carbongemini-4-carbon	$2.3529≈ ¥16.01	$0.1176≈ ¥0.8	$11.7647≈ ¥80.05	—	—	—	—
Gemini Flash Latestgemini-flash-latest	$1.80≈ ¥12.25	$0.18≈ ¥1.22	$9.00≈ ¥61.24	—	—	1M	—
Gemini Flash Lite Latestgemini-flash-lite-latest	$0.72≈ ¥4.90	$0.072≈ ¥0.49	$6.00≈ ¥40.82	—	—	1M	—
Gemini PRO Latestgemini-pro-latest	$4.80≈ ¥32.66	$0.48≈ ¥3.27	$28.80≈ ¥195.96	—	—	1M	—

无倍率：表中价格即扣减价格。官方价为 Google 公布的标价；“折”是本站价占官方价的十分之几，向上取整。上下文与输入类型来自目录，“—”表示目录里没有记录。

一轮对话和一篇长文档各多少钱

一轮对话按输入 2,000、输出 500 tokens 计；一篇长文档按输入 50,000、输出 2,000 tokens 计，也就是把一份报告整篇发进去，要一段摘要。

模型	一轮对话	一篇长文档	$10 够处理几篇长文档
Gemini 4 Argongemini-4-argon	$0.0027≈ ¥0.0184	$0.036≈ ¥0.245	277
Gemini 3.1 Pro Previewgemini-3.1-pro-preview	$0.006≈ ¥0.0408	$0.0744≈ ¥0.506	134
Gemini 3.8 Flashgemini-3.8-flash	$0.0021≈ ¥0.0144	$0.0291≈ ¥0.198	343

按目录实时价计算，未计缓存命中；实际费用以每次请求的回执为准。

Gemini 常被用来读长材料：整份合同、一个代码仓库、一段会议录音的转写。这类请求的花费几乎全在输入上，所以选型时先看输入单价和上下文长度，再看输出单价。同一份材料要反复提问时，第二次起重复的部分命中缓存，按缓存输入价计，回执里会把这部分 tokens 单独列出来。

curl、Python、Node：OpenAI 兼容格式

先用 curl 确认密钥和地址，再换进 SDK；只改 base_url、密钥和 model。

bash

1curl -i https://api.relayswitch.io/v1/chat/completions \

2 -H "Authorization: Bearer sk-relay-..." \

3 -H "Content-Type: application/json" \

4 -d '{"model": "gemini-4-argon", "messages": [{"role": "user", "content": "回复 ok"}]}'

python

1from openai import OpenAI

3client = OpenAI(base_url="https://api.relayswitch.io/v1", api_key="sk-relay-...")

4reply = client.chat.completions.create(

5 model="gemini-4-argon",

6 messages=[

7 {"role": "system", "content": "用一句话回答。"},

8 {"role": "user", "content": "Gemini 的上下文窗口有多大？"},

9 ],

10)

11print(reply.choices[0].message.content)

12print(reply.usage) # prompt_tokens / completion_tokens，与回执一致

javascript

1import OpenAI from "openai";

3const client = new OpenAI({ baseURL: "https://api.relayswitch.io/v1", apiKey: "sk-relay-..." });

4const stream = await client.chat.completions.create({

5 model: "gemini-3.8-flash",

6 messages: [{ role: "user", content: "用三点概括这段文字：……" }],

7 stream: true,

8});

9for await (const chunk of stream) {

10 process.stdout.write(chunk.choices[0]?.delta?.content ?? "");

11}

Base URL 带 /v1，SDK 自己在后面拼 /chat/completions。流式输出把 stream 设为 true，返回 server-sent events，和 OpenAI 的格式相同，上面的 Node 示例就是流式写法。

从 Google 的 OpenAI 兼容地址迁过来

如果代码原本是照 Google 的 OpenAI 兼容文档写的，它已经在用 OpenAI SDK 了，迁移只动三处：

base_url：从 Google 文档里的地址换成 https://api.relayswitch.io/v1。
api_key：从 AI Studio 的密钥换成本站的 sk-relay- 密钥。
model：对照上面的价格表核对一遍 id，以表里此刻列出的为准；写错返回 404 model_not_found。

请求体不用改。Google 文档里通过 extra_body 传的 Gemini 专有字段，本页没有逐项验证，用到的话先拿一条请求测一下，再看回执里的计费是否符合预期。

Gemini 原生格式：generateContent

已经按 Google 的请求格式写好的程序不用改写。此刻目录里 19 个 Gemini id 接这条路由。

bash

1curl -i "https://api.relayswitch.io/v1beta/models/gemini-3.8-flash:generateContent" \

2 -H "x-goog-api-key: sk-relay-..." \

3 -H "Content-Type: application/json" \

4 -d '{"contents": [{"parts": [{"text": "回复 ok"}]}]}'

路径是 /v1beta/models/{model}:generateContent，注意它在域名后面直接跟 /v1beta，不带 /v1。密钥放在 x-goog-api-key 头里，不要写进 URL：带在查询参数里的密钥会被网关拒绝。请求体和响应体都是 Google 的结构，contents 进，candidates 出。

两种格式的报错也各随各的结构。OpenAI 格式下，错误在 error.code 里；原生格式下是 Google 的写法，例如没带密钥时返回 401，error.status 为 UNAUTHENTICATED。无论哪种，网关自己的错误码都写在响应头 x-uplink-error 里，请求 id 在 x-uplink-request-id 里。按状态码排查的对照表在 GPT / OpenAI API 中转站的错误码一节，Gemini 走 OpenAI 格式时完全适用。

Gemini 选哪个型号

量大、要低延迟用 Flash，长而难的推理用 Pro 或 Argon。这条线多数型号都有百万 token 上下文，所以选的是每次回答的价格，而不是装不装得下。型号名里带 preview 的是预览版，Google 之后会换成正式的名字，所以写进代码的 id 要以价格表此刻列出的为准。

选型不必靠猜：所有 Gemini id 都在同一把密钥上，同一条提示各发一次，对比回答和回执上的花费就有结论。想把 Gemini 和 GPT、Claude 放在一起比，改的也只是 model 一个字段，见 GPT / OpenAI API 中转站和 Claude API 中转站。

上线之前

给生产环境单独建一把密钥，设美元预算和每日消费上限，再用模型白名单把它限定在你选定的几个 Gemini id 上。读长文档的程序尤其要设上限：一次误把整个目录发进去的请求，输入就是几十万 tokens。失败的请求看响应头 retry-after 决定等多久再试。

国内开发者接入：四件事

本站只提供 API 和计费，不提供任何网络接入服务。下面是接入时问得最多的四件事。

事项	本站的做法	详情
账户一个邮箱	填邮箱、收验证码即可登录。不要手机号，不要身份证件，也不需要在模型开发商那里开户。	要什么，不要什么
付款USDT 或银行卡，最低 $10	余额以美元计，不过期，没有订阅和月费。页面上的人民币是按欧洲央行汇率折算的参考价，不参与计费。	充值方式与到账
配置改 base_url、密钥和 model	OpenAI SDK 或任何能填 Base URL 的工具都可以接；按 Google 原生格式写的程序走 generateContent 路由。	文档与 SDK 示例
发票与支持国际 PDF 发票	在控制台填公司抬头、地址和税号，每次充值生成一张带编号的发票；不开中国增值税发票。支持渠道是邮箱 hello@relayswitch.io。	交付与退款条款

改 base_url，再改 model

Base URL https://api.relayswitch.io/v1，Gemini 模型按实时标价计费，无倍率，每天公开验真。

模型与价格获取密钥