type
status
date
slug
summary
tags
category
icon
password
适用场景：中国大陆开发者接入 Google Gemini 图像生成 API（Imagen / Nano Banana）

一、模型选择

Google 目前提供两个主要生图模型：
模型 ID
别名
免费 API 额度
价格（标准分辨率）
适用场景
gemini-2.5-flash-image
Nano Banana
有，每天 500 张
$0.039/张
大多数日常生图需求
gemini-3-pro-image-preview
Nano Banana Pro
无，必须开启计费
$0.134/张（2K）、$0.24/张（4K）
专业级图文混排、高精度文字渲染
结论： 除非有高精度文字渲染需求，优先使用 gemini-2.5-flash-image，免费额度足够日常测试和中小规模使用。

二、获取 API Key 的途径

2.1 官方途径 A：Google AI Studio（推荐先试）

  • 需要科学上网
  • 用 Google 账号直接登录，无需绑卡即可生成 API Key
  • gemini-2.5-flash-image 有免费额度，无需信用卡
操作步骤：
  1. 登录 AI Studio
  1. 点击右上角头像 → Get API Key
  1. 选择 Create API key in new project
  1. 复制生成的 Key，妥善保存（只显示一次）

2.2 官方途径 B：Google Cloud Vertex AI

  • 适合需要 gemini-3-pro-image-preview 的场景
  • 新用户有 $300 免费赠金（90 天有效），约可生成 2000 张 2K 图
  • 必须绑定境外信用卡（见下方绑卡说明）
  • 服务调用建议部署在香港/新加坡服务器，国内调用需代理

2.3 第三方中转

不想折腾绑卡和代理的替代方案：
服务商
支付方式
特点
302.AI
支付宝
按量计费，支持 Gemini/Imagen
AiHubMix
支付宝
兼容 OpenAI SDK 格式
OpenRouter
境外信用卡
多模型聚合，支持 Gemini
第三方服务的 API Key 通常兼容 OpenAI SDK，调用时只需修改 base_url 和 api_key。

三、Google Cloud 注册绑卡流程

3.1 地区选择

注册时不能选中国大陆，Google Cloud 不对大陆提供服务。
地区与支付卡保持一致：
  • 有香港银行卡（汇丰、渣打、DBS 实体卡）→ 选香港
  • 有台湾信用卡 → 选台湾
  • 有国内全币种 Visa/Mastercard（招行、浦发）→ 选美国（填俄勒冈/蒙大拿州地址，税率为 0）

3.2 填写联系信息（以香港 DBS 为例）

DBS Bank 地址参考：
填写对应：
  • 区（第一级）：香港岛
  • 区（第二级）：中环（即 Central）
  • 街道地址：G/F, The Center, 99 Queen's Road Central
  • 邮编：香港无邮编，留空或填 000
  • 法定名称：与银行卡一致的英文姓名

3.3 绑卡注意事项

Google Cloud 不接受预付卡（Prepaid Card），以下类型会被拒：
  • Wise 虚拟卡（预付卡性质）
  • 各类一次性虚拟卡
推荐使用：
  • 香港实体信用卡（DBS、汇丰、渣打）
  • 国内招商银行全币种 Visa 信用卡
  • 国内浦发 Mastercard 标准信用卡

四、baoyu-img-gen 工具配置

配置文件路径：项目根目录 EXTEND.md（YAML frontmatter）

4.1 推荐配置（使用免费 Flash 模型）

4.2 付费 Pro 模型配置

4.3 注意事项

  • YAML 中 # 后面的内容为注释，支持行尾注释和独立行注释
  • default_quality: 2k 对 Flash 模型是否生效取决于工具内部的参数映射逻辑，建议跑一张测试图确认实际输出分辨率
  • Flash 模型免费额度：每天 500 张，每分钟约 2 张，超出后按 $0.039/张 计费

五、API 调用示例

Python

JavaScript / TypeScript

六、费用速查

模型
分辨率
单价
$300 赠金可生成张数
gemini-2.5-flash-image
标准
$0.039/张
~7,692 张
gemini-3-pro-image-preview
2K
$0.134/张
~2,238 张
gemini-3-pro-image-preview
4K
$0.240/张
~1,250 张

七、参考链接

📌 声明：本文由 AI （Claude Sonnet 4.6）辅助完成