跳转到主要内容

核心要点

  • API易 已收录:模型名为 gpt-6.1-terra,标准输入 $1、输出 $5、缓存读取 $0.05 / 百万 tokens,与 OpenAI 对应标准价格一致。
  • 视觉与文字任务并重:官方定位覆盖商品图片匹配、技术图纸理解、屏幕操作及文字修改;支持图片输入,输出为文本。
  • 105 万上下文:官方上下文窗口为 1,050,000 tokens,最大输出为 128,000 tokens;容量上限与长上下文计费需要分开看。
  • 支持关闭推理:可选 none、low、medium、high、xhigh、max,默认 medium。
  • 工具调用走 Responses:普通文本可参考下方两种接口示例;接入函数工具时使用 /v1/responses。

发布背景与定位

OpenAI 在 2026 年 10 月 26 日的 API 更新日志中发布 GPT-6.1 Terra。本文于 10 月 27 日核对官方文档和 API易公开定价接口,确认平台模型列表已加入该型号,并完成下方接口功能实测。 Terra 的关注点是视觉推理、计算机操作和自然文字表达。对开发者来说,可以先从已有工作流中的具体一步试用:匹配商品图与目录记录、理解图纸标注、根据屏幕截图判断界面状态,或修改一段已有文稿。 这些是官方描述的任务方向,不能替代业务验收。截图是否看得准、修改后的文字是否保持原意、工具参数是否可靠,都应使用自己的样本逐项检查;本文不提供未经复现的性能排名或速度倍数。

规格与接入边界

本表为 OpenAI 官方规格。API易公开目录已列出 CodexResponses、default、svip 分组;具体权限以令牌所属分组为准。下方测试验证当前测试令牌的接口功能,不代表所有分组、全部工具或完整上下文上限均已验证。

接口实测

2026 年 10 月 27 日(UTC+8),使用同一测试令牌完成 50 次生成请求,最多 20 个并发任务用于加快测试。每次都核对内容与结束状态,未使用自动重试;这是功能验证,不是容量压测。 缓存不能按两端点一概而论:同一前缀各连续请求 3 次,Responses 后两次均回报 2,653 个缓存命中 tokens;Chat 三次均未回报缓存命中。因此本轮只确认 Responses 样本出现命中,不保证 Chat 的缓存收益。 推理档位测试验证的是参数可用与简单题结果,不是各档能力排序;不能据此断言高档一定更好。测试也未覆盖百万上下文、缓存保留时长、超过 272K 的实际扣费或长期稳定性。

迁移时注意参数差异

GPT-6.1 Terra 支持 none,不要直接套用 GPT-6.1 Sol 不支持关闭推理的限制。已有应用迁移时,先保持原有推理档位、输入样本和输出要求一致,再判断效果变化。 当推理档位不是 none 时,按官方迁移指南移除 temperature、top_p、top_logprobs;Chat Completions 也不要传 logprobs。若业务需要工具调用,使用 Responses,并按响应中的调用参数执行工具、回传结果。

调用示例

使用 OpenAI Python SDK,安装命令为 pip install -U openai。先在本地环境配置 APIYI_API_KEY,不要把真实 Key 写进脚本、前端或提交记录。 本轮已验证两种接口的基础参数形式。以下示例从环境变量读取 Key;首次接入先运行简短文本请求,再加入图片、工具或长文档。
完整参数和工具结果处理见 Responses API、兼容接口 与 响应处理。

价格与可用性

标准价格

以下价格于 2026 年 10 月 27 日核对,单位为美元 / 百万 tokens,未叠加充值加赠或账户分组折扣;对应官方标准档、输入不超过 272K tokens 的口径。
模型价格与官网对齐,且可能随官网调整;上表仅供参考,具体以顶部导航「模型价格」栏目为准:模型价格。
例如,10,000 个未缓存输入 tokens 加 2,000 个输出 tokens,按标准单价计算为 $0.02,不含缓存写入、额外工具费用及分组折扣。这是计费示例,不是单次任务的固定报价。

缓存与长上下文

API易公开配置登记的缓存写入单价为 $1.25 / 百万 tokens。OpenAI 官方分别列出 30 分钟和 12 小时保留期,价格为 $1.25 与 $2.50;平台公开字段未标明保留时长,不能据此承诺两种模式均已开放。
官方规定:输入超过 272K tokens 时,整次请求输入及缓存按基础价的 2 倍、输出按 1.5 倍计费。本次 API易公开配置未列出 Terra 专属阶梯条件,因此不能将官方阶梯费率直接当作已实测的平台扣费结果,也不能承诺百万上下文全程按基础价。大请求先核对控制台计费,并做小额验证。
公开目录列出的分组为 CodexResponses、default、svip。模型价格、分组权限及附加功能以当前控制台为准,充值活动见 充值优惠说明。

接入建议

先用少量固定样本检查三件事:答案是否满足要求、接口参数是否兼容、实际账单是否符合预算。视觉任务增加模糊图片和小字截图;文字任务检查事实和原意;工具任务检查参数及结果回传。记录每次请求的模型名、推理档位和 token 用量,便于复现差异。

信息来源

资料核对日期:2026 年 10 月 27 日(UTC+8)。外部来源以文本列出,可复制访问。
  • OpenAI 发布日志:developers.openai.com/api/docs/changelog
  • OpenAI 模型规格:developers.openai.com/api/docs/models/gpt-6.1-terra
  • OpenAI 标准价格:developers.openai.com/api/docs/pricing
  • OpenAI 参数与迁移指南:developers.openai.com/api/docs/guides/latest-model
  • API易实时定价:公开价格接口、公开倍率配置、模型价格。