薅 Gemini API 免费额度批量生成 listing 脚本教程

如果你在 1688 选品、往 Shopify 或 Amazon 上批量铺货，每条 listing 都丢进网页版聊天框手动复制粘贴，那是在用最贵的方式用免费工具。免费额度最强的杠杆，是那把 API key，它能让你写脚本一次喂一批商品，机器自己跑。

为什么免费额度才是真正的白嫖入口

网页版的 Gemini 一次只能处理一个对话，复制粘贴的人力成本远超模型本身。真正不要钱又能上量的，是 Google AI Studio 给的免费 API key。

拿 key 不要绑信用卡：登录 Google AI Studio，点 Get API key，几秒钟出一串。

有一点得先说清楚：Google 近期收紧了 API key 的默认权限，新建的 key 可能默认只开了部分接口或加了来源限制。建好之后进 key 的设置页看一眼当前配置，别等脚本跑起来报 403 才回头查。

免费额度到底有多少，别只看官方数字

官方文档对 Gemini 2.5 Flash / Flash-Lite 免费档标的上限大致是每天 1500 次请求（RPD）、每分钟 10 到 15 次（RPM），每分钟的 token 额度也比较宽松。

但官方上限和实测是两回事。不少人反馈实际能跑到的 RPD 远低于这个数，有的账号只有 250 上下，跟地区、账号是否完成验证都有关系。所以把 1500 当天花板看，按你自己账号实测的数字来排产，别照着官方数字排满。

Pro 模型免费档很紧，大约每天 50 次，批量铺货基本指望不上，老老实实用 Flash 系列。

额度按太平洋时间午夜重置，挂夜里跑刚好赶上新一天的配额。

档位	大致 RPD	大致 RPM	适合干啥
2.5 Flash-Lite 免费	官方 ~1500（实测可能低很多）	~15	短描述、要点、标题，量大
2.5 Flash 免费	官方 ~1500（实测可能低很多）	~10-15	长描述、多语言铺货
2.5 Pro 免费	~50	紧	偶尔精修，不适合批量
付费 Batch API	按量计费	异步队列	上万条、要 SLA

这里要纠正一个常见误会：Gemini 那个专门的 Batch API 是付费才能用的，免费档没有真正意义上的”批处理”。我们说的”免费批量”，是你自己写循环、按免费的 RPD/RPM 限速跑，不是调那个异步队列。这是两码事。

一个脚本的骨架

思路很简单：把商品列表读进来，每次请求塞 5 到 10 个商品一起生成，限速到每分钟十来次，结果落盘。一批塞多个商品是关键，因为 RPD 是按”请求次数”算的，一次请求出 10 条，1500 次理论上就是上万条草稿。

import time, json
import google.generativeai as genai

genai.configure(api_key="YOUR_FREE_KEY")
model = genai.GenerativeModel("gemini-2.5-flash-lite")

products = json.load(open("products.json"))   # 你的选品列表
BATCH = 8          # 一次请求塞 8 个商品
DELAY = 5          # 每次请求间隔，限速到约 12 RPM

results = []
for i in range(0, len(products), BATCH):
    chunk = products[i:i + BATCH]
    prompt = build_prompt(chunk)   # 文案模板见下方交叉链接
    try:
        resp = model.generate_content(prompt)
        results.append(resp.text)
    except Exception as e:
        print("limited or failed, backing off:", e)
        time.sleep(60)            # 撞限速就退避一分钟再续
    time.sleep(DELAY)

json.dump(results, open("listings.json", "w"), ensure_ascii=False)