ToAPIs

Gemini 3 Pro Official 完整解析（Markdown）

返回模型解析页

Gemini 3 Pro Official API 模型解析指南

快速结论

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

核心能力

  • 通用对话与推理：支持多轮上下文理解与结构化输出。
  • 流式响应：支持 SSE 增量输出，适合实时交互体验。
  • 工具调用：可结合 tools 编排检索、执行与自动化流程。

适用场景

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

不适用场景

  • 纯图像或视频生成任务。
  • 只需简单模板文本、不需要推理能力时。

运行特性

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

最小请求示例

{
  "model": "gemini-3-pro-official",
  "messages": [
    {
      "role": "user",
      "content": "请总结这个模型适用场景"
    }
  ],
  "max_tokens": 200
}

最小响应示例

{
  "id": "chatcmpl_xxxxxxxx",
  "model": "gemini-3-pro-official",
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "finish_reason": "stop"
    }
  ]
}

关键参数

参数类型必填默认值范围说明
modelstring是gemini-3-pro-official-模型标识，使用 ToAPIs 真值。
messagesobject[]是--按时间顺序组织的对话消息。
max_tokensinteger是->=1最大输出 token 数。
streamboolean否false-是否启用流式返回。
toolsobject[]否--函数调用定义集合。

常见错误

HTTPCode触发条件修复建议重试策略
400invalid_request_error请求体字段缺失或类型错误。校验 model/messages/max_tokens 参数。修复参数后重试。
401authentication_errorAPI Key 缺失或无效。检查 Authorization 头与密钥权限。修复鉴权后重试。

FAQ

  1. Gemini 3 Pro Official 适合哪些任务？
    适合对话、推理、代码与工具调用等通用 AI 助手场景。

相关 API