Gemini 3 Pro Preview 即将停用：3月9日前迁移到 Gemini 3.1 Pro 完整指南

Google 宣布 Gemini 3 Pro Preview 将于2026年3月9日正式停用。如果你正在通过 API 使用该模型——无论是直接调用还是通过代理——你需要在截止日期前迁移到 Gemini 3.1 Pro Preview。

以下是具体的变更内容、升级带来的优势,以及如何以最小的改动完成迁移。

时间线:关键日期

谁需要采取行动?

如果以下任一情况适用于你,你需要立即行动:

• 你在 API 请求中调用了 gemini-3-pro-preview 或 gemini-pro-latest
• 你有基于 Gemini 3 Pro 构建的流水线、Agent 或自动化任务
• 你使用了 thinking_budget 参数(该参数已被替换——详见下文)

Gemini 3.1 Pro 与 3 Pro:有什么不同?

这不仅仅是一次版本升级。Gemini 3.1 Pro Preview 带来了显著的改进,尤其是在推理能力方面。

推理性能

核心数据:Gemini 3.1 Pro 在 ARC-AGI-2 上得分 77.1%,是 Gemini 3 Pro 的两倍以上。这意味着在需要多步逻辑、数据综合和复杂代码生成的任务上,性能有明显提升。

输入与输出

功能特性

Gemini 3.1 Pro 支持前沿模型应有的完整功能集:

• 思维模式 — 内置思维链推理
• 函数调用 — 结构化工具使用
• 结构化输出 — JSON Schema 强制约束
• 代码执行 — 在沙箱中运行代码
• 文件搜索 — 查询上传的文档

破坏性变更:thinking_budget → thinking_level

迁移步骤

迁移过程非常简单——大多数情况下只需修改一行代码。

第一步:更新模型名称

将:

替换为:

第二步:更新 thinking_budget(如有使用)

第三步:测试你的提示词

Gemini 3.1 Pro 总体上更优秀,但输出可能有所不同。在上线生产环境前,请运行你的评估套件或抽查关键提示词。

代码示例:通过 EvoLink 调用 Gemini 3.1 Pro

curl -X POST "https://api.evolink.ai/v1beta/models/gemini-3.1-pro-preview:generateContent" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "Explain the key differences between TCP and UDP, with examples of when to use each."
          }
        ]
      }
    ]
  }'

curl -X POST "https://api.evolink.ai/v1beta/models/gemini-3.1-pro-preview:streamGenerateContent" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "Write a Python function that finds the longest palindromic substring in O(n) time."
          }
        ]
      }
    ]
  }'

为什么通过 EvoLink 使用 Gemini 3.1 Pro?

价格优势

Gemini 3 Pro 和 3.1 Pro 的定价完全相同——迁移不会产生任何额外费用。

OpenAI SDK 兼容

无需学习新的 SDK 或重写集成代码。如果你已经在使用 OpenAI Python/Node SDK,只需将请求指向 EvoLink 的端点并更换模型名称即可。

过渡期间两个模型同时可用

TL;DR

• Gemini 3 Pro Preview 将于2026年3月9日停用。gemini-pro-latest 别名将在3月6日切换到 3.1 Pro。
• Gemini 3.1 Pro 是一次重大升级——推理性能提升2倍以上,功能集和定价不变。
• 大多数情况下迁移只需一行代码:将 gemini-3-pro-preview 替换为 gemini-3.1-pro-preview。
• 如果使用了思维功能,注意 thinking_budget → thinking_level 的变更。
• EvoLink 现已支持两个模型,定价最高比 Google 直连便宜74%。