Gemini API 国内怎么用:地区限制与直连

先说结论:免费层是真的,但国内用不上

Google AI Studio 的免费 API 层确实存在:不需要绑定billing账号,创建 Key 就能用,这一点和 Anthropic、OpenAI 的官方付费起步不一样。但这个免费层建立在 Google 的受支持地区列表之上,中国大陆不在这份列表里,意味着账号地区设置和访问网络都要落在受支持范围内,国内开发者要稳定用上它,门槛并不比办一张海外银行卡低多少。 经 kkaiapi 这类直连网关,不需要处理账号地区和网络环境问题,base_url 换成 https://api.kkaiapi.com/v1,支付宝或微信充值即可调用 gemini-3.1-pro-preview 和 gemini-3.5-flash,人民币按量计费,同一个 Key 还能调用 Claude、GPT、DeepSeek 等模型。

Google AI Studio 免费层实际是什么样

AI Studio 的免费 API 层按三个维度限流:每分钟请求数、每分钟 token 数、每日请求数,三个上限里先撞到哪个,超出的请求就会返回 429,等窗口重置。Flash 系模型的免费额度相对宽松,Pro 系模型在三个维度上的上限都低得多。这些数字属于 Google 会随时调整的运营参数,不带绝对承诺,只能当作社区实测的参考区间。 还有一层容易被忽略的条款:免费层的请求和回复,按 Google 当前条款可能被用于产品改进,包括人工审核;付费 API 流量不在这个范围内。处理任何敏感内容,这一条比请求速率限制更值得留意。

地区限制是国内真正的门槛

AI Studio 和 Gemini API 都建立在 Google 的受支持国家/地区列表上,中国大陆目前不在这份列表内。这意味着账号的地区设置、注册环节的验证方式,以及请求发出时所在的网络环境,都需要落在受支持范围内才能稳定通过。这和 Anthropic、OpenAI 官方要求海外手机号、海外银行卡的门槛是同一类问题——不是免费额度不够用,而是国内身份和网络本身就无法稳定通过官方的准入检查。 对比 Claude、GPT 需要的是海外银行卡,Gemini 这边缺的是受支持地区的账号与网络环境,两者对国内开发者造成的结果是一样的:官方免费层理论上存在,实际能不能用得看能不能先解决身份和网络这道门槛。

经 kkaiapi 直连:三分钟跑通

标准的 OpenAI 兼容写法,base_url 固定,model 填 gemini-3.1-pro-preview 或 gemini-3.5-flash,请求体结构和调用其他任何模型一样。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KKAIAPI_KEY"],
    base_url="https://api.kkaiapi.com/v1",
)

resp = client.chat.completions.create(
    model="gemini-3.5-flash",
    messages=[{"role": "user", "content": "用三句话总结长上下文模型的适用场景"}],
)
print(resp.choices[0].message.content)

gemini-3.1-pro-preview 和 gemini-3.5-flash 怎么选

kkaiapi 目前提供这两个 Gemini 3.x 系列 ID,两者共用同一个 Key 和 base_url,换模型只改一个字符串。

• gemini-3.5-flash:更新一代,Agent 循环和编码类任务优先选它,官方自己的评测把它排在 3.1 Pro 之上,价格也更低
• gemini-3.1-pro-preview:适合需要深度推理的长上下文任务,repository 级代码理解、多文档综合分析是它的定位场景
• 两个 ID 上下文窗口都是 1M token,不确定选哪个就用同一份 prompt 各跑一遍,几分钟出结论,不用凭印象站队

价格对照:人民币直接计价

价格按 kkaiapi 中文区实时价格计算,单位 ¥/1M tokens(输入/输出),完整价目见价格页。

常见问题