Python 配置 Gemini 免费模型 gemini-2.5-flash

用 Google Gemini API（免费额度很高）。Gemini 模型（如 Gemini 2.5 Flash 或 2.5 Pro）支持多模态（文本+图像），免费 tier 额度在 2026 年仍算慷慨（例如 Gemini 2.5 Flash 每天可达数百到上千请求，视模型而定；速率限制如 10-15 RPM，每分钟请求数）。

下面一步步教你从零开始使用（假设你有电脑 + Python 环境）。

步骤 1：获取免费 Gemini API Key（无需信用卡）

1. 打开浏览器，访问：**https://aistudio.google.com**（Google AI Studio）。

2. 用你的 Google 账号 登录（Gmail 即可，如果没有就注册一个）。

3. 登录后，如果弹出条款同意页面，阅读并**接受 Gemini API Terms of Service** 和 Additional Terms（点同意）。

4. 在左侧菜单或页面底部，找到 “Get API key” 按钮（或直接访问：https://aistudio.google.com/app/apikey）。

5. 点击 “Create API key”（创建新密钥）。

- 选择 “Create API key in new Google Cloud project”（推荐新手，新项目自动创建，便于管理）。

- 给项目起个名字，比如 “TikTok-Shop-Helper”。

- 点击 Create。

6. API key 会立即显示（格式如 AIzaSy... 开头的一长串）。

- 马上复制保存（点复制图标，或手动复制），因为页面刷新后可能不会再完整显示。

- 建议存到记事本或环境变量（后面代码会用）。

注意：这个 key 是免费的，不需要绑定信用卡（2026 年免费 tier 仍无需支付即可使用基本模型）。如果提示地区限制（墨西哥应该没问题），试试 VPN 或换个 Google 账号。

步骤 2：安装 Python 库

打开命令提示符（Windows）或终端（Mac/Linux），运行：

```bash

pip install -U google-genai

```

- 这会安装最新的 Google GenAI SDK（2026 年官方推荐库，原 google-generativeai 已 deprecated，转用 google-genai）。

- 如果报错，确保 Python 是 3.9+ 版本。

步骤 3：写第一个 Python 脚本测试

from google import genai
import os

# 设置 API Key（推荐用环境变量，安全）
# 在 PowerShell 先运行一次：
# 或者临时在代码里写（测试用，别上传分享）：
os.environ["GOOGLE_API_KEY"] = "AIzaSyBHeYoH13"

# 创建客户端（自动读取环境变量里的 GOOGLE_API_KEY）
client = genai.Client()

# 直接用字符串指定模型（推荐！不需要 .get()）
prompt = """
根据TikTok Shop新品折扣工具的规则（早鸟价、限时、总限购20件、买家限购1件等），
帮我生成一个针对巴西市场的黑白男士T恤促销文案。
商品：黑白两色，尺码P到XXXL。
原价 R$89,90，打折后 R$49,90。
用葡萄牙语写，结构：吸引人的标题 + 3-5个卖点 + 呼吁行动。
强调限时优惠和库存有限。
"""

# 生成内容（直接传 model=字符串）
response = client.models.generate_content(
    model="gemini-2.5-flash",   # ← 这里直接写模型名字符串
    contents=prompt
)

print("Gemini 的回复：")
print(response.text)