Google · Gemini 3.1 系列
Gemini 3.1 Pro
Google Gemini 3 系列当前 Pro Preview,面向复杂推理、软件工程和需要精确工具使用的代理式工作流。
查看 API 文档
访问方式:Hosted API
它是什么
Gemini 3.1 Pro Preview 由 Google 通过 Gemini API 提供。官方模型代码是 gemini-3.1-pro-preview,TodayAI 保留稳定 slug gemini-3-1-pro,不把 Preview 后缀写进公开 URL。
官方模型页将其定位为改进思考、token 效率和多步工具执行的 Pro 规格。它仍是 Preview,不是已经宣告稳定的 GA 终点。
Gemini 应用、NotebookLM 等产品能力不能直接写成这个 API 模型的原生能力。同一家族的 Flash 更偏速度;2.5 Pro 是前代规格,官方计划于 2026-10-16 停止服务。
核心能力
多模态输入
官方模型表列出文本、图像、视频、音频和 PDF 输入,输出为文本。
推理与编程
官方说明面向软件工程行为、可用性,以及需要可靠多步执行的代理式工作流。
工具与结构化输出
官方能力表标明 Function calling 与 Structured outputs 受支持;Thinking 受支持。
长上下文
官方输入 token 上限为 1,048,576,输出上限为 65,536。
适合什么任务
- 需要当前 Gemini Pro 规格的复杂推理
- 多步工具调用和代理式编码任务
- 跨文本、图像、音视频材料的理解
- 从 Gemini 2.5 Pro 评估迁移的团队
API 与技术信息
- API
- Hosted API
- Model ID
- gemini-3.1-pro-preview
- Context
- 1,048,576 tokens
- 输入
- Text · Image · Video · Audio · PDF
- 输出
- Text
- Tool calling
- Yes
- Structured output
- Yes
- Reasoning
- Yes
Gemini API 官方输入 token 上限;输出上限为 65,536
使用时要注意
- 官方状态为 Preview,模型代码是 gemini-3.1-pro-preview,不要写成已 GA。
- 另有 gemini-3.1-pro-preview-customtools 端点,只在自定义工具与 bash 混用时才需要评估。
- 应用层文件上传不等于任意文件格式都按同一路径解析。
- 生成内容仍需核验来源和数字。
官方资料
相关模型
相关 TodayAI 指南
- 用 Gemini Function Calling 连接外部动作把函数描述交给 Gemini,让模型返回要调用的函数名与参数。按官方 Interactions API 示例跑通最小闭环。
- 用 Gemini Structured Outputs 约束 JSON 结果按官方 Structured outputs:用 JSON Schema / Pydantic 约束 Gemini 的最终回答格式,提取菜谱等结构化数据并可直接校验。
- 用 Gemini File Search 做托管文档检索创建 File Search store、上传文档、等待索引,再在 Interactions 中启用 file_search 做 RAG 问答。