模型解析页

Gemini 3 1 Pro

模型 ID: gemini-3-1-pro

厂商: Google (Gemini)能力类型: Chat价格: Input $0.40/1M, Output $2.40/1M更新于: 2026-05-02

Gemini 3 1 Pro 由 Google (Gemini) 提供，适用于通用对话、推理与工具调用工作流。该页面聚焦 ToAPIs 契约下的接入路径与生产参数实践。

在 Playground 中打开文档

模型概览

快速结论

支持 Chat Completions 接入，便于快速迁移现有 SDK。
支持流式输出与工具调用，适合 Agent 场景。
建议先收敛 system/messages 参数，再进入生产环境。

Gemini 3 1 Pro模型特点

核心能力

能力一览与工程实践价值

通用对话与推理

支持多轮上下文理解与结构化输出。

流式响应

支持 SSE 增量输出，适合实时交互体验。

工具调用

可结合 tools 编排检索、执行与自动化流程。

如何使用 Gemini 3 1 Pro API

设置 Authorization: Bearer <YOUR_API_KEY>。
调用聊天接口并传入 model、messages、max_tokens。
按需开启 stream 或配置 tools。
根据 stop_reason 处理收尾或工具续轮。

适用场景

需要代码助手、问答助手、流程自动化 Agent 时。
需要流式输出和函数调用能力时。

API 运行特性

接口为无状态调用，多轮上下文由业务侧在 messages 中传递。
开启 stream 后返回 SSE 事件流。

关键参数

参数	类型	必填	默认值	取值范围	说明
model	string	是	gemini-3-1-pro	-	模型标识，使用 ToAPIs 真值。
messages	object[]	是	-	-	按时间顺序组织的对话消息。
max_tokens	integer	是	-	>=1	最大输出 token 数。
stream	boolean	否	false	-	是否启用流式返回。
tools	object[]	否	-	-	函数调用定义集合。

常见错误

400 invalid_request_error

触发条件: 请求体字段缺失或类型错误。

修复建议: 校验 model/messages/max_tokens 参数。

重试策略: 修复参数后重试。

401 authentication_error

触发条件: API Key 缺失或无效。

修复建议: 检查 Authorization 头与密钥权限。

重试策略: 修复鉴权后重试。

FAQ

Gemini 3 1 Pro 适合哪些任务？

适合对话、推理、代码与工具调用等通用 AI 助手场景。

模式说明

Chat Completions 模式（Gemini 3 1 Pro）

OpenAI 兼容聊天入口，便于快速接入。

模式参数

modelmessagestemperaturemax_tokensstream

最佳应用场景

智能问答
代码助手
流程编排

Streaming 模式（Gemini 3 1 Pro）

开启 stream 获取增量响应。

模式参数

streammessagesmax_tokens

最佳应用场景

实时助手
终端输出
逐段展示

Tool Calling 模式（Gemini 3 1 Pro）

通过 tools 声明函数并触发外部执行。

模式参数

toolstool_choicemessagesmax_tokens

最佳应用场景

自动跑测试
检索后回答
多步 Agent

Gemini 3 1 Pro

模型概览

快速结论

Gemini 3 1 Pro模型特点

通用对话与推理

流式响应

工具调用

如何使用 Gemini 3 1 Pro API

适用场景

API 运行特性

关键参数

常见错误

400 invalid_request_error

401 authentication_error

FAQ

Gemini 3 1 Pro 适合哪些任务？

模式说明

Chat Completions 模式（Gemini 3 1 Pro）

Streaming 模式（Gemini 3 1 Pro）

Tool Calling 模式（Gemini 3 1 Pro）

相关 API

准备开始统一接入 AI 模型了吗？