搜「gemini api有哪些」的人,通常不是想背一份模型名单,而是打开文档发现入口有好几个、模型名字像套娃,不知道该从哪下手。这篇不给你罗列型号,只讲三件事:接口入口怎么分、模型按什么维度挑、计费和额度在哪看当期数字。看完你至少能判断自己该走哪条路,哪些坑可以提前绕开。
搜「gemini api有哪些」的人,十有八九是打开文档之后先懵了一下。入口有好几个,模型名字看着像套娃,翻两页就不知道自己到底该接哪个。其实这事儿不复杂,难的是你还没想清楚自己要什么,就先被模型名单带跑了。
这篇不给你列型号,因为型号会变,列了也没用。只讲三件事:接口入口怎么分、模型按什么维度挑、计费和额度在哪看当期数字。看完你至少能判断自己该走哪条路,哪些坑可以提前绕开。
先分清你接的是哪个入口,不是先挑模型
Gemini 的调用入口至少有三种:官方直连、云厂商托管、第三方聚合平台。这三条路的计费主体和限速规则完全不一样,选错了后面每一步都别扭。判断方法就一句话——问自己「这笔钱最后付给谁」。付给 Google,那就是官方直连或者云平台;付给某个中转平台,那就是聚合路线。
| 入口类型 | 账单落在哪 | 限速和额度看哪里 |
|---|---|---|
| 官方直连(API key) | 绑定项目下的用量 | 项目控制台里的用量页 |
| 云厂商托管 | 云账号账单,计费单位和折扣跟着云走 | 云平台的配额页 |
| 第三方聚合平台 | 平台自己定价,接口只保证兼容 | 平台自己的文档和后台 |
有个细节容易忽略:走云平台的时候,你创建 key 的项目和区域如果填错,免费额度可能压根没生效,直接按付费走。这种返工最冤。想对照两条官方路线的差异,去 /official-api/providers/google 和 /official-api/providers/google-vertex 看,两边的规格和入口说明是分开写的。
模型不是越新越好,先按任务类型分堆
模型名单越长,越容易犯一个错:拿最贵最强的那个去跑批量任务,跑完一看账单心疼。实际用下来,先分堆比先比价有用得多。把候选模型按「要快要便宜」「要强推理」「要多模态输入输出」三堆放,先定堆,再在堆里比单价。
- 批量分类、摘要、简单问答:往「快而便宜」那堆找,别碰旗舰型号
- 复杂推理、代码生成、多步任务:往「强推理」那堆找,单价高但少返工
- 图片、音频、视频输入输出:先确认这个模型支不支持你要的模态,再谈价格
- 拿不准就先在一两个小任务上跑通再扩,不要一次性把所有任务迁过去
还有个坑:同一个模型在预览版和稳定版之间,可用性、限速和不支持的功能不一样。生产环境别默认跟预览版,模型名里带 preview 字样的,先确认它当前支持什么、限速多少。这类差异去 /models 看规格,不要凭模型名猜。
价格和额度别背数字,去页面看当期值
Gemini 的计费按输入、输出 token 分开算,长上下文和多模态输入还会改变 token 的计数方式。所以别人截图里的单价,对你未必成立。具体单价到 /official-api 核对当时的表格,按你自己的输入输出比例估算才有意义。
免费额度和限速是两套东西,这点很多人搞混。免费层通常有每分钟请求数和每天用量的双重限制,触到哪一条,报错信息都不一样。规则看 /official-api/providers/google,别拿论坛里的旧帖当依据。
- 估算用量按你自己的日均请求数和平均 token 数,到 /tools/model-cost-calculator 算一遍,得到的是当期口径下的估算值
- 设上限在项目里设好用量上限和告警,再跑批处理任务;没设上限就跑一夜,额度超了才知道
- 核对账单归属确认 key 绑定的项目和区域正确,避免免费额度没生效直接进付费
几个实际会让人返工的动作
下面这几个动作,单独看都不算大错,但凑在一起就是一次完整的返工。我见过最常见的顺序是:先把 key 写进前端,跑通了很开心,第二天发现 key 泄露得换,换完账单归属还得重算。
- 把 API key 直接写进前端代码,第二天就得换 key 并重算账单归属
- 用错误的区域或项目创建 key,免费额度没生效,直接进付费
- 没设用量上限就先跑批处理任务,跑一夜才发现额度早超了
- 用预览版模型上生产,限速一变整个服务跟着抖
这些动作的共性是:都发生在你还没确认入口和账单位置之前。所以顺序反过来——先定入口,再设上限,最后才写调用代码。用量记录和告警的设置方式,参考 /usage 里的说明。判断标准也简单:任何一步你不确定钱付给谁、额度从哪扣,就先停下来去核对,别往下写。
下一步把入口和账单位置确认清楚之后,再去比价格和模型规格,顺序对了能省掉大半返工。到 /official-api 看当期价格表,到 /models 看模型规格,两边对着看一遍就够。→常见问题
Gemini API 和 Google AI Studio 是一回事吗?
不是。AI Studio 是网页端试用和拿 key 的地方,API 是真正调用的接口。在 AI Studio 里试出效果不等于接口侧一定有同样的额度和限速,开通前到 /official-api/providers/google 看清楚接口侧的价格和限制说明。
免费额度够不够做一个小项目?
看你的调用频率和单次输入长度,免费层通常卡在每分钟请求数和每日总量两处。原型阶段够用,一旦给外部用户用就容易撞限速。判断标准是有没有并发用户,有的话就按付费预算来规划。
国内网络环境调不通怎么办?
先分清是网络不可达还是鉴权失败,报错码不一样处理方式也不同。可以考虑走云厂商托管入口或第三方聚合平台,但计价主体会变,接入前到 /ai-nav/category/ai-api 对一遍各家的倍率口径。