> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GPT-6.1 Terra 上线

> GPT-6.1 Terra 已在 API易模型列表上线，标准输入 1 美元、输出 5 美元每百万 tokens。本文介绍视觉推理定位、105 万上下文、推理档位、调用示例与计费边界。

## 核心要点

* **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 的关注点是视觉推理、计算机操作和自然文字表达。对开发者来说，可以先从已有工作流中的具体一步试用：匹配商品图与目录记录、理解图纸标注、根据屏幕截图判断界面状态，或修改一段已有文稿。

这些是官方描述的任务方向，不能替代业务验收。截图是否看得准、修改后的文字是否保持原意、工具参数是否可靠，都应使用自己的样本逐项检查；本文不提供未经复现的性能排名或速度倍数。

## 规格与接入边界

| 项目 | 官方规格 |
| - | - |
| 模型 ID | `gpt-6.1-terra` |
| 上下文窗口 | 1,050,000 tokens |
| 最大输出 | 128,000 tokens |
| 知识截止 | 2026 年 6 月 1 日 |
| 输入 / 输出 | 文本、图片 / 文本 |
| 推理力度 | `none`、`low`、`medium`（默认）、`high`、`xhigh`、`max` |
| 功能 | 流式输出、函数调用、结构化输出 |

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

## 接口实测

2026 年 10 月 27 日（UTC+8），使用同一测试令牌完成 **50 次生成请求**，最多 20 个并发任务用于加快测试。每次都核对内容与结束状态，未使用自动重试；这是功能验证，不是容量压测。

| 检查项 | 请求数 | 观察结果 |
| - | - | - |
| 基础预检、中英文与算术 | 8 | 两端点均返回预期结果 |
| 流式输出 | 4 | 文本增量正确，且收到正常结束信号 |
| JSON Schema | 4 | 字段、类型与指定值均符合要求 |
| 六档推理与默认档 | 14 | 参数均可提交，简单题均答对 |
| 图片理解 | 4 | 两端点均正确识别合成图中的指定颜色 |
| Responses 工具闭环 | 2 | 返回正确参数，接收本地工具结果并答出 42 |
| 多轮对话 | 4 | Chat 消息历史与 Responses `previous_response_id` 均保留测试信息 |
| 缓存重复请求 | 6 | 文本均正确；命中差异见下文 |
| 长输入抽查 | 4 | 两端点均取回隐藏标记，实际输入分别为 8,230 与 32,806 tokens |

**缓存不能按两端点一概而论**：同一前缀各连续请求 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；首次接入先运行简短文本请求，再加入图片、工具或长文档。

```python Responses API theme={null}
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["APIYI_API_KEY"],
    base_url="https://api.apiyi.com/v1",
)

response = client.responses.create(
    model="gpt-6.1-terra",
    reasoning={"effort": "low"},
    input="将这句话改得更清楚，不改变原意：项目将在确认接口后开始联调。",
    max_output_tokens=1024,
)
print(response.output_text)
```

```python Chat Completions theme={null}
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["APIYI_API_KEY"],
    base_url="https://api.apiyi.com/v1",
)

response = client.chat.completions.create(
    model="gpt-6.1-terra",
    reasoning_effort="none",
    messages=[{"role": "user", "content": "用一句话说明如何检查接口返回是否成功。"}],
    max_completion_tokens=1024,
)
print(response.choices[0].message.content)
```

完整参数和工具结果处理见 [Responses API](https://docs.apiyi.com/api-capabilities/openai/native.md)、[兼容接口](https://docs.apiyi.com/api-capabilities/openai/compatible.md) 与 [响应处理](https://docs.apiyi.com/api-capabilities/openai/response-handling.md)。

## 价格与可用性

### 标准价格

以下价格于 2026 年 10 月 27 日核对，单位为美元 / 百万 tokens，未叠加充值加赠或账户分组折扣；对应官方标准档、输入不超过 272K tokens 的口径。

| 计费项 | API易公开价格 | OpenAI 标准价格 |
| - | - | - |
| 输入 | \$1.00 | \$1.00 |
| 输出 | \$5.00 | \$5.00 |
| 缓存读取 | \$0.05 | \$0.05 |

> [!NOTE]
>
> 模型价格与官网对齐，且可能随官网调整；上表仅供参考，具体以顶部导航「模型价格」栏目为准：[模型价格](https://docs.apiyi.com/models/index.md)。

例如，10,000 个未缓存输入 tokens 加 2,000 个输出 tokens，按标准单价计算为 \$0.02，不含缓存写入、额外工具费用及分组折扣。这是计费示例，不是单次任务的固定报价。

### 缓存与长上下文

API易公开配置登记的缓存写入单价为 \$1.25 / 百万 tokens。OpenAI 官方分别列出 30 分钟和 12 小时保留期，价格为 \$1.25 与 \$2.50；平台公开字段未标明保留时长，不能据此承诺两种模式均已开放。

> [!WARNING]
>
> 官方规定：输入超过 272K tokens 时，整次请求输入及缓存按基础价的 2 倍、输出按 1.5 倍计费。本次 API易公开配置未列出 Terra 专属阶梯条件，因此不能将官方阶梯费率直接当作已实测的平台扣费结果，也不能承诺百万上下文全程按基础价。大请求先核对控制台计费，并做小额验证。

公开目录列出的分组为 `CodexResponses`、`default`、`svip`。模型价格、分组权限及附加功能以当前控制台为准，充值活动见 [充值优惠说明](https://docs.apiyi.com/faq/recharge-promotions.md)。

## 接入建议

先用少量固定样本检查三件事：答案是否满足要求、接口参数是否兼容、实际账单是否符合预算。视觉任务增加模糊图片和小字截图；文字任务检查事实和原意；工具任务检查参数及结果回传。记录每次请求的模型名、推理档位和 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易实时定价：[公开价格接口](https://api.apiyi.com/api/pricing)、[公开倍率配置](https://api.apiyi.com/api/ratio_config)、[模型价格](https://docs.apiyi.com/models/index.md)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.