> ## 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/zh-Hant/api-capabilities/openai/native.md)、[相容介面](https://docs.apiyi.com/zh-Hant/api-capabilities/openai/compatible.md) 與 [響應處理](https://docs.apiyi.com/zh-Hant/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/zh-Hant/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/zh-Hant/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/zh-Hant/models/index.md)。


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