把长材料放进同一分析框架
长上下文适合同时组织规范、代码、报告与历史讨论，围绕同一问题比较约束和结论。比起只要求总结，更适合指定需要检查的矛盾、依赖和例外，并要求按章节或文件标识给出依据，让长材料分析形成可复核的交付物。
规格与接口特性
在选型前明确容量、输入输出与调用方式。
- 原生输入上限
- 1,048,576 tokens
- 原生输出上限
- 65,536 tokens
- 原生输入与输出
- 文本、图像、音频、视频、PDF 输入；文本输出
- 推理与结构化能力
- Thinking、函数调用、结构化输出
- 版本与知识时间
- 稳定版 gemini-2.5-pro；型号更新于 2025 年 6 月，知识截止于 2025 年 1 月
- 对话调用
- /gemini/chat/completions；文本与图片消息、流式响应
- 会话调用
- /aichat2/conversations；保存历史、文件 URL 内容块与会话管理
原生容量与模态描述模型能力；具体输入方式、工具执行及会话功能由所选本平台入口分别提供。
核心能力
了解 gemini-2.5-pro 能为你的工作带来什么。
聚焦代码与多步骤推理
Gemini 2.5 Pro 的思考能力面向代码、数学和 STEM 问题，可用于解释算法、分析故障条件或推导方案。提交任务时加入输入条件、已有尝试和验收标准，要求分别给出结论、假设及验证方法，便于后续测试，而不只是得到一段解释。
从图文理解到结构化结果
图片可与文字问题一起输入，用于解释截图、图表或示意图；结果仍以文本交付。结合结构化输出和函数调用能力，可将分析整理为字段明确的记录，或提出工具调用请求。工具执行与结果校验应由应用或授权的会话工作流承担。
适用场景
从具体任务出发，找到模型发挥作用的位置。
跨文件代码审查
输入相关模块、接口约定、错误日志和复现步骤，要求模型检查调用链、边界条件与潜在回归。交付物可包括按文件分类的问题清单、修改建议及测试用例草案。保留文件路径与版本信息，方便开发者定位并验证建议，而不是直接接受修改。
多文档条款对照
将合同、制度与业务要求整理成文本，或通过会话入口提交可访问的文件链接，要求逐项比较适用范围、例外和相互矛盾的条款。输出差异表、待确认问题与摘要，并保留章节依据，适合审阅前的材料整理和后续追问。
图表解释与技术评审
把架构图、产品截图或实验图表与背景说明一起提交，明确需要解释的关系、异常或设计取舍。模型可生成文字分析、评审提纲与验证清单。对关键数值先提供清晰原图或文本数据，有助于区分图中观察和进一步推断。
如何选择这个模型
结合任务复杂度、输入材料与预期结果选择。
复杂分析优先，简单任务先做取舍
当任务需要在长材料中保持约束、分析代码关系或完成多步骤推理时，Gemini 2.5 Pro 是合适的候选。若只是短文本分类、简单改写或固定字段提取，可把 Flash 系列纳入对照测试，以实际准确率、响应体验和用量决定，不必为每个任务都选择 Pro。
稳定版与预览版分开评估
gemini-2.5-pro 是稳定版代码，与 gemini-3.1-pro-preview 不是同一版本。已有项目可围绕当前提示词、结构化结果和工具流程继续评估 2.5 Pro；考虑切换版本时，应使用相同材料回归测试，不要把预览版本的参数或表现直接视为本型号具备的能力。
开始使用
从一次小规模任务到正式接入。
准备任务与材料
明确目标、必要输入与输出要求，使用真实业务样例作为起点。
在 API 调试区试用
打开试用页，确认此入口支持的参数，再提交小规模任务查看结果。
按 API 文档接入
保留完整模型 ID，使用文档规定的请求格式，并在 Pricing 页确认计费规则。
使用边界
在正式使用前，了解输出质量与能力范围。
- 原生多模态输入不等于每个入口都接受相同附件。Chat Completions 可按文本和 image_url 块组织图文；文件链接可使用会话入口的 file_url。不要把 PDF、录音或视频链接直接当成图片字段的通用用法。
- 该型号输出为文本，不生成图片或语音，也不属于 Live API 实时音视频模型。可以让它解释视觉材料、撰写配音稿或生成绘图说明，但真正的媒体生成需要选用相应的创作模型。
- 知识截止于 2025 年 1 月，近期事实应补充新材料。长上下文也不意味着自动找到每处细节；重要条款、代码结论和数学推导应要求明确依据，再通过人工审阅、测试或计算验证。
常见问题
解答使用 gemini-2.5-pro 时的常见疑问。
Gemini 2.5 Pro 能一次处理多长的材料？
原生输入上限为 1,048,576 tokens，输出上限为 65,536 tokens，二者分别计算。组织长材料时应保留章节和文件标识，并明确分析范围；这些是模型原生上限，不代表每次调用都会返回最大长度。
怎样把截图与问题一起提交？
在 /gemini/chat/completions 中，将消息 content 写成内容块数组，同时放入 text 与 image_url。文字说明需要检查的位置和任务，图片用于提供视觉信息；回复从 choices 中读取，流式调用则拼接 delta.content。
分析 PDF 应选哪个入口？
需要提交文件链接时，可选择 /aichat2/conversations，用 message 数组中的 file_url 块提供文件，并加入文本任务。也可先提取 PDF 文本再发送普通消息。文件读取是会话工作流的一环，与原生 PDF 理解应分开看待。
能让 Gemini 2.5 Pro 自动运行代码吗？
模型原生支持代码执行和函数调用，但普通对话中生成代码或工具参数不等于已经执行。自行管理工具时，应用需执行函数并回填结果；使用会话工具流程时，实际操作取决于可用工具和授予的权限。
连续追问时要重复发送全部历史吗？
使用 Chat Completions 时，由客户端在 messages 中组织相关历史。使用 /aichat2/conversations 时，可开启 stateful 并在后续请求带回同一个 id，让会话继续保存上下文；不希望保存该轮时可设置 stateful: false。
模型资料 · 更新日期：2026-10-01。调用参数与计费规则请查看 API 和定价栏目。