Browse documentation
Gemini 配置
使用专用的 Gemini 渠道调用 Gemini。请在控制台创建 API Key,并将类型选择为 Gemini。渠道只影响额度的消耗速度(0.625 倍),不会改变你购买的 Token 额度。
此渠道支持由客户端声明并执行的函数。Google 搜索和 Google 地图等托管工具会在转发前返回 HTTP 400。代理会立即转发有效内容,并按上游报告的实际用量结算。显式 cachedContent 引用可能包含工具定义,也会被拒绝。自动缓存仍可使用。
生成请求使用标准服务档位。请求未定价的档位或通过 fileData 引用远程文件会返回 HTTP 400。如果请求体也指定了模型,名称必须与 URL 一致。可使用同一把密钥调用 countTokens 统计文本和内联媒体的 token 数,此操作不消耗生成额度。
使用 GET /v1beta/models 查看可用模型。
API Key 和实际扣费账户的余额都大于 0 时即可发起生成请求。请求的输出和工具上限按原设置转发,完成后按实际用量结算;并发请求可能让余额变成负数。
支持的模型
| 模型 | 渠道 | 输入 | 缓存 | 输出 |
|---|---|---|---|---|
gemini-3.5-flash | Gemini · 默认 | 0.625 | 0.0625 | 1.875 |
gemini-3.7-flash | Gemini | 0.625 | 0.0625 | 1.875 |
gemini-3.8-flash | Gemini | 0.625 | 0.0625 | 1.875 |
表格中的价格是 Gemini 渠道实际生效的每 100 万 Token 美元价格(上游价格乘以渠道 0.625 倍消耗系数)。Gemini 模型不能使用 AWSQ、CCMAX 或 Codex 类型的 Key 调用。如果您的工作需要 GPT 模型,请改用 Codex 类型的 Key;GPT-6.1 Sol 与 Terra 比较这两个 GPT-6.1 模型的差异。
Carbon 採用官方首發優惠價格。Google 只標示日期,未指定時區;本站統一於 **2026-12-01 00:00 UTC(北京時間 08:00)**切換費率。輸出包含 thinking tokens。
Gemini 渠道亦支援 gemini-4-carbon。當前輸入、緩存讀取與輸出費率,請到即時價格表選擇 Gemini。Carbon 在 2026-12-01 00:00 UTC 前按設定的常規基礎費率 5 折計算,之後恢復常規費率。即時價格表已包含此優惠與渠道倍率。
Gemini CLI
官方 Gemini CLI 安装指南要求 Node.js 20.0.0 或更高版本。先检查本机版本:
1 node --version
如果尚未安装 Node.js,或版本低于 20.0.0,请先安装受支持的版本。以下配置已按 Gemini CLI 0.67.0 验证,请安装该版本以复现这些步骤:
1 npm install -g @google/[email protected]2 gemini --version
配置项目
进入项目目录,创建 .gemini/settings.json。如果文件已存在,请合并以下字段,并将 customOverrides 条目追加到已有数组。API Key 通过环境变量提供,不要写入这个文件。
1 {2 "security": { "auth": { "selectedType": "gemini-api-key" } },3 "model": { "name": "gemini-3.8-flash" },4 "modelConfigs": {5 "customOverrides": [6 {"match": {"model": "base"}, "modelConfig": {"model": "gemini-3.8-flash"}},7 {"match": {"model": "gemini-3-pro-preview"}, "modelConfig": {"model": "gemini-3.8-flash"}},8 {"match": {"model": "gemini-3-flash-preview"}, "modelConfig": {"model": "gemini-3.8-flash"}},9 {"match": {"model": "gemini-3.1-flash-lite"}, "modelConfig": {"model": "gemini-3.8-flash"}},10 {"match": {"model": "gemini-2.5-pro"}, "modelConfig": {"model": "gemini-3.8-flash"}},11 {"match": {"model": "gemini-2.5-flash"}, "modelConfig": {"model": "gemini-3.8-flash"}},12 {"match": {"model": "gemini-2.5-flash-lite"}, "modelConfig": {"model": "gemini-3.8-flash"}}13 ]14 },15 "agents": {16 "overrides": {17 "codebase_investigator": { "modelConfig": { "model": "gemini-3.8-flash" } }18 }19 },20 "tools": { "exclude": ["google_web_search", "web_fetch"] }21 }
这份配置使用 API Key 认证,将主对话、内置辅助请求、上下文压缩和代码仓库调查子代理统一设为 gemini-3.8-flash。单独使用 --model 不会覆盖所有辅助模型或子代理模型。本站不支持托管 Google 搜索和 URL 上下文工具,因此配置中关闭了这两项;本地文件和 shell 工具仍可使用。
从项目目录启动
将占位符替换为控制台创建的 Gemini 类型 Key。首次启动时,按 CLI 提示确认项目可信,以便加载项目配置:
1 export GEMINI_API_KEY="YOUR_DASHBOARD_API_KEY"2 export GOOGLE_GEMINI_BASE_URL='https://api.aiinide.com'3 gemini --model gemini-3.8-flash
请保留显式模型参数:没有项目配置时直接运行 gemini,使用的是客户端 Auto 路由,不是本站模型目录标记的默认模型。升级 CLI、切换模型或增加自定义代理/扩展时,也要重新核对它们的模型配置。如果出现 Model "…" is not configured,请检查报错中的模型名称以及实际加载的配置。详细说明见官方模型配置和子代理配置指南。
客户端只能使用控制台创建的 Key,不要使用服务器环境中的上游 GEMINI_API_KEY。
环境变量
Gemini 客戶端會在 Base URL 後加上 /v1beta/models/...。
1 export GEMINI_API_KEY="YOUR_DASHBOARD_API_KEY"2 export GOOGLE_GEMINI_BASE_URL='https://api.aiinide.com'
普通请求
接口遵循 Gemini generateContent 请求格式。下面的示例包含需要解释的完整代码,不会读取本地文件。请将占位符替换为控制台创建的 Gemini 类型 Key,并在兼容 Bash 的终端中运行。下面的普通请求和流式请求都会按实际用量消耗可用额度。
1 export GEMINI_API_KEY="YOUR_DASHBOARD_API_KEY"2 3 curl --globoff --fail-with-body 'https://api.aiinide.com/v1beta/models/gemini-3.8-flash:generateContent' \4 -H "x-goog-api-key: $GEMINI_API_KEY" \5 -H "Content-Type: application/json" \6 -d '{7 "contents": [{8 "role": "user",9 "parts": [{"text": "用一句话解释这个 JavaScript 函数的返回值:function add(a, b) { return a + b; }"}]10 }],11 "generationConfig": {"temperature": 0.2}12 }'
检查 candidates[].content.parts[].text 中是否有回答,以及对应候选结果的 finishReason 是否为 "STOP"。例如:“将两个数字相加;如果其中一个值是字符串,则进行字符串拼接。”具体措辞可能不同。如果没有回答,请检查 promptFeedback 和 finishReason;MAX_TOKENS 表示已达到输出上限。代理会在响应后记录实际用量,可在用量历史中核对。
流式请求
沿用上面导出的 Key,将 generateContent 替换为 streamGenerateContent,并使用 curl -N 实时显示返回的片段:
1 curl --globoff --fail-with-body -N 'https://api.aiinide.com/v1beta/models/gemini-3.8-flash:streamGenerateContent?alt=sse' \2 -H "x-goog-api-key: $GEMINI_API_KEY" \3 -H "Content-Type: application/json" \4 -d '{5 "contents": [{"role": "user", "parts": [{"text": "用一句话解释这个 JavaScript 函数的返回值:function add(a, b) { return a + b; }"}]}]6 }'
响应包含 SSE data: 事件。按顺序读取 candidates[].content.parts[].text 中的回答片段,并确认该候选结果以 finishReason: "STOP" 结束;回答应解释同一个函数。仅收到 HTTP 200 或第一个文本片段不能证明请求完整成功,连接中断或其他结束原因都需要进一步检查。
常见问题
401:请确认使用的是有效且未过期的 Gemini 类型控制台 Key。400:检查模型名称,并确认 Key 类型是 Gemini。429:该 API Key 的购买额度或请求限制已达到上限。503:Gemini 上游暂时不可用,请稍后重试。
原有 Base URL 的 /api/codex 和 /api/gemini 前綴繼續支援,原 Key 可沿用。