Gemini 3.1 Pro API：模型名、价格、上下文和调用方法（2026）

先说结论

Gemini 3.1 Pro 是 Google 在 2026 年 2 月 19 日发布的 Pro 模型，现在仍是预览版，模型名 gemini-3.1-pro-preview，在 TeamoRouter 上也用这个名字。单次最多输入 1,048,576 token、输出 65,536 token。Google 官方价是每百万输入 token $2、输出 $12（输出含思考 token），单次请求超过 20 万 token 时是 $4 / $18。TeamoRouter 写作当天（2026 年 10 月 22 日）约为官方价的 4.9 折，实时价格见模型页。

Gemini 3.1 Pro 是什么，现在还值得用吗

按 Google 的说法，Gemini 3.1 Pro 是第三代 Pro 模型，面向多模态理解、Agent 任务和写代码。和 Gemini 3 Pro 比，它思考得更好、更省 token、回答更贴合事实，针对软件工程和需要准确调用工具的多步任务做了优化。上一代 gemini-3-pro-preview 已在 2026 年 3 月 9 日停用，这个旧名字现在指向 3.1 Pro。

2026 年 10 月 13 日，Gemini 4 Argon 在 Gemini API 正式上线。两者的官方价（每百万 token，请求不超过 20 万 token）：

	Gemini 3.1 Pro	Gemini 4 Argon
输入	$2	$2（到 11 月 30 日），12 月 1 日起 $4
输出	$12	$10（到 11 月 30 日），12 月 1 日起 $20
单次最大输出	65,536 token	100 万 token

怎么选：

新项目、要很长的输出：先试 Argon。写作当天在 TeamoRouter 上 Argon 约官方价 2.9 折，比 3.1 Pro 的约 4.9 折便宜。
已经按 3.1 Pro 调好了提示词和工具调用：可以接着用。按 Google 官方价，12 月 1 日 Argon 涨到 $4 / $20 以后，3.1 Pro 会比 Argon 便宜。

截至 2026 年 10 月 22 日，Google 的弃用页面上没有公布 3.1 Pro 的停用日期。

参数一览

来自 Google 的 Gemini 3.1 Pro 模型页：

	Gemini 3.1 Pro
模型名	`gemini-3.1-pro-preview`
发布	2026 年 2 月 19 日（预览版）
输入	文本、图片、视频、音频、PDF
输出	文本
输入上限	1,048,576 token
输出上限	65,536 token
思考档位	`low`、`medium`、`high`（默认），不支持 `minimal`
工具调用、结构化输出、代码执行	支持

Google 还有一个 gemini-3.1-pro-preview-customtools 端点，会更优先使用你自己定义的工具；TeamoRouter 上架的是 gemini-3.1-pro-preview。

价格

Google 官方价（Gemini API 价格页，标准档，每百万 token）：

	请求 ≤ 20 万 token	请求 > 20 万 token
输入	$2.00	$4.00
输出（含思考 token）	$12.00	$18.00
缓存输入	$0.20	$0.40

缓存存储另收每百万 token 每小时 $4.50。Google 的 Batch 和 Flex 档是标准价的一半。

TeamoRouter 按实际用掉的 token 计费，写作当天约为官方价的 4.9 折，没有月费。价格会随上游调整，实时价格见模型页和价格页。

思考用掉的 token 按输出价算。默认的 high 档想得最多，单次请求也最贵；简单任务调到 low，更快也更省。

国内怎么调用

Google 公布的 Gemini API 可用地区列表里没有中国大陆和香港。TeamoRouter 提供 OpenAI 兼容格式和 Gemini 原生格式两种接口，现有代码只要换接口地址和 Key。Key 在控制台创建。

OpenAI 兼容格式（base URL 带 /v1）：

python

from openai import OpenAI

client = OpenAI(base_url="https://api.teamorouter.vip/v1", api_key="你的 TeamoRouter API Key")
resp = client.chat.completions.create(
    model="gemini-3.1-pro-preview",
    reasoning_effort="low",
    messages=[{"role": "user", "content": "找出这段代码里的并发问题：..."}],
)
print(resp.choices[0].message.content)

reasoning_effort 对应 Gemini 的思考档位（low、medium、high），不写就是 Google 默认的 high。

Gemini 原生格式（地址前面不加 /v1）：

bash

curl https://api.teamorouter.vip/v1beta/models/gemini-3.1-pro-preview:generateContent \
  -H "Authorization: Bearer 你的 TeamoRouter API Key" \
  -H "content-type: application/json" \
  -d '{
    "contents": [
      {"role": "user", "parts": [{"text": "用一句话解释什么是上下文窗口"}]}
    ]
  }'

Google 建议 Gemini 3 系列的 temperature 保持默认的 1.0，调低可能出现循环输出、效果变差。完整参数见 API 接入文档。

在 Gemini CLI 和 Cherry Studio 里用

Gemini CLI：设好三个环境变量，启动时用 -m 指定模型：

bash

export GOOGLE_GEMINI_BASE_URL="https://api.teamorouter.vip"
export GEMINI_API_KEY="你的 TeamoRouter API Key"
export GEMINI_API_KEY_AUTH_MECHANISM="bearer"
gemini -m gemini-3.1-pro-preview

安装步骤见 Gemini CLI 接入文档。

Cherry Studio：设置 → 模型服务 → 「+ 添加」，提供商类型选 Gemini，API 地址填 https://api.teamorouter.vip，获取模型列表后勾选 gemini-3.1-pro-preview。见 Cherry Studio 接入文档。

怎么付费

没有订阅，在控制台充值余额，按实际用掉的 token 扣费，最低 $5 起充，支持支付宝。同一份余额也能调用 Claude、GPT 和其他 Gemini 模型。

常见问题

gemini-3.1-pro-preview 会停用吗？ 截至 2026 年 10 月 22 日，Google 没有公布停用日期。它是预览版，上一代预览版 gemini-3-pro-preview 已在 3 月 9 日停用，长期项目要留意 Google 的弃用页面。

思考能关掉吗？ 不能完全关。3.1 Pro 最低是 low 档，不支持 minimal。

超过 20 万 token 的请求怎么算钱？ Google 官方价是输入 $4、输出 $18。在 TeamoRouter 上的实时价格以模型页为准。

能在 Codex 里用吗？ 不能。Codex 通过 Responses 接口发请求，TeamoRouter 的 /v1/responses 只支持 GPT 系列，请求 Gemini 会返回 400。命令行里用 Gemini 请用 Gemini CLI。

需要 Google 账号吗？ 不需要。一个 TeamoRouter Key 就能调用 Gemini、Claude 和 GPT。

下一步

Gemini 3.1 Pro 模型页——看实时价格。
创建 API Key，发第一条 gemini-3.1-pro-preview 请求。
Gemini 4 Argon API——Google 新一代旗舰。
Gemini 3.8 Flash API——便宜、快的 Flash 款。

准备好接入了吗？登录控制台 · 购买额度 · 创建 API Key，三步即可开始。

获取 API Key 查看帮助文档

文中模型的实时价格

Gemini 3.1 Pro Preview价格、时延、可用率 →

继续阅读

全部文章