词元建议：创作者不必先上 Gemini CLI。优先用 OpenAI 兼容 SDK 指向 https://www.gpt345.com/v1。若已有 CLI，只改 Key、Base URL 和模型代号，并按 429 降并发。
1. 什么时候才用 CLI
CLI 适合本机试模型；批量主图、视频和账单验收更适合脚本。词元把 Gemini 文本和生图放进同一账户，CLI 只是其中一种客户端。
- Key 放环境变量，不要写进命令历史截图。
- Base URL 只保留一次
/v1，SDK 会自动拼接。 - 生图必须换图片模型代号，公开参考 0.01 元/张。
2. 配置 API
CLI 的 Gemini 入口改三个值：Base URL 指向词元、认证方式选 API Key、模型代号从模型广场原样复制。Google OAuth 登录态和词元 Key 是两套凭证，混在一起必报错。
3. Windows 检查
- 环境变量设完要新开终端，当前进程读不到。
echo %GEMINI_API_KEY%（CMD）或$env:GEMINI_API_KEY（PowerShell）确认有值。- 代理软件开着时，CLI 可能走代理线路，直连更稳。
4. 最小请求验证
先发一条最短文本请求，然后到控制台核对三件事：有请求记录、余额变动、模型代号与请求一致。对上再跑批量。429 先降并发和频率，不要立刻原样重发。
5. 多模态与生图
文本模型出不了图。生图换 Gemini 图片模型代号（如 Gemini 3.1 Flash Image），按张计费公开参考 0.01 元/张；同一把 Key 只改 model。批量前先按生图指南的 10 张规则验证。
6. 常见问题
7. 常见问题 FAQ
CLI 报 Invalid auth method 怎么办？
多半是官方 Gemini 凭证和第三方 Base URL 混用。改用词元 API Key，不要套 Google 登录态。
CLI 能出 0.01 元的图吗？
能，前提是模型代号是图片模型。用文本 Flash 出不了按张账单。
CLI 还是 SDK 怎么选？
交互试模型用 CLI，批量与账单验收用 SDK 脚本。两者共用同一把词元 Key。
客服 QQ 49098022 或 Telegram 群组。