跳到主要内容
Router One
注册
返回博客

GPT-6.1 Terra API 接入指南：国内调用、工具调用与计费

发布约 13 分钟读完作者Router One 团队方法说明
GPT-6OpenAIGPTCodex模型选型API 网关指南

OpenAI 于 2026 年 10 月 26 日发布了 GPT-6.1 Terra；截至 2026-10-28 的模型目录，Router One 以 openai/gpt-6.1-terra 列出它。GPT-6.1 Terra 模型页为它列出两个端点：Codex CLI 使用的 POST /v1/responses，以及 POST /v1/chat/completions。国内开发者不需要海外账号、不需要 VPN：把 OpenAI 兼容 SDK 或客户端的 base URL 换成 https://api.router.one/v1，用 Router One 的 Key 发 "model": "openai/gpt-6.1-terra"，请求就会像目录里其他模型一样被路由、计费并记入日志。截至 2026-10-28 的套餐接口，GPT-6.1 Terra 不在任何套餐档位，无论是否订阅，每次调用都按 token 从钱包扣费；实时单价看模型页。

本文依次讲清：目录对这个 id 公开了什么，OpenAI 怎么把它与 GPT-6.1 Sol、GPT-6 Astra、GPT-5.6 Terra 区分，为 GPT-6.1 Sol 或 GPT-5.6 Terra 写的请求要改哪些地方，OpenAI 对 computer use 的说明，没有套餐覆盖时费用怎么算，以及两个端点上的第一个请求怎么发。文中的目录与套餐信息都注明了观察日期，发起新请求前以实时目录为准。

GPT-6.1 Terra 速览

项目目录所列（2026-10-28）
目录 idopenai/gpt-6.1-terra，截至 2026-10-28 的模型目录已列出
上下文窗口1,050,000 token
输入 / 输出文本、图像输入，文本输出
能力标签chat、streaming、tool calling、vision
价格线两条：标准价格线，以及单次输入严格超过 272,000 token 时适用的整单价格线
端点POST /v1/responses 与 POST /v1/chat/completions（以模型页所列为准）
不提供的端点POST /v1/messages（只服务 Claude 系列与 DeepSeek id）
渠道只在默认渠道提供，2026-10-28 的模型目录没有它的 Azure 渠道 ID
套餐不在 Pro、Max、Ultra 的任何档位（2026-10-28 套餐接口），按钱包计费

OpenAI 官方的 GPT-6.1 Terra 模型页（2026-10-28 核对）补充了目录里没有的信息：它把这个模型描述为 "a fast, efficient model for visual reasoning, precise computer use, and clear, natural writing"（面向视觉推理、精确的 computer use 与清晰自然写作的快速高效模型），在 1,050,000 token 窗口内最多输入 922,000 token、最多输出 128,000 token，知识截止日期为 2026 年 6 月 1 日；reasoning.effort 可取 none、low、medium（默认）、high、xhigh 与 max。同一页还写明：工具调用必须走 Responses API。以上是厂商的说法；Router One 负责的是目录条目本身，以及网关如何路由和计费。

选 GPT-6.1 Terra、GPT-6.1 Sol、GPT-6 Astra 还是 GPT-5.6 Terra？

OpenAI 的 GPT-6 指南（2026-10-28 核对）给每个模型配了一句定位：GPT-6 Astra 是 "highest intelligence"（智能最高），GPT-6.1 Sol 是 "balanced speed, cost, and intelligence"（速度、成本与智能兼顾），GPT-6.1 Terra 是 "fast and efficient"（快速高效），适合视觉推理、精确的 computer use 和清晰自然的写作，比如把商品照片对上目录条目、比对技术图纸、在应用界面上操作，或者起草、修改文字。OpenAI 的模型选择指南（2026-10-28 核对）建议：依据给定材料写简洁文字、目标明确的 computer use 任务和范围清晰的代码修复，可以先试 GPT-6.1 Terra，并用相同的输入和推理强度把它与 GPT-6.1 Sol 对比。更早的 GPT-5.6 Terra，按它自己的模型页，面向兼顾智能与成本的工作负载。这些是 OpenAI 的描述，不是 Router One 的测量；把一类任务迁过去之前，先用你自己的提示词在相同输入上跑一遍。

Router One 这一侧，选择时还要看三点：

  • 扣套餐额度还是走钱包。 截至 2026-10-28 的套餐接口，GPT-6.1 Terra 不在任何套餐档位，所有账户都按钱包计费；GPT-6.1 Sol 计入 Pro、Max、Ultra 的「高级模型」额度，GPT-5.6 Terra 计入三个套餐的「中级模型」额度，GPT-6 Astra 计入 Max 与 Ultra 才有的「旗舰模型」额度。
  • 公示单价。 Router One 为每个 id 单独公示单价。下面的对比页会渲染实时数字，切换前请重新核算成本。
  • 请求路径相同。 四者都是 GPT 系列 id，模型页都把它们列在 Codex CLI 使用的 /v1/responses 和 /v1/chat/completions 上。

两个对比页用实时目录把规格和单价并排渲染出来：

  • GPT-6.1 Terra vs GPT-6.1 Sol——OpenAI 自己建议的对比；按 2026-10-28 的套餐接口，GPT-6.1 Sol 扣「高级模型」额度，GPT-6.1 Terra 不在任何套餐档位、按钱包计费。
  • GPT-6.1 Terra vs GPT-5.6 Terra——代际升级：工具调用要改走 Responses API；按 2026-10-28 的套餐接口，GPT-5.6 Terra 扣「中级模型」额度，GPT-6.1 Terra 按钱包计费。

从 GPT-6.1 Sol 或 GPT-5.6 Terra 切过来，请求要改什么

从别的 GPT id 换到 GPT-6.1 Terra，Key、base URL 和端点都不变；OpenAI 模型页给 GPT-6.1 Terra、GPT-6.1 Sol 与 GPT-5.6 Terra 列出的 1,050,000 token 窗口、最大输入与最大输出、输入类型也都相同。会变的是下面几项，依据是 OpenAI 的 GPT-6 指南（迁移速查与 GPT-6.1 Terra 一节，2026-10-28 核对）：

从 GPT-6.1 Sol 切过来：

  • model 字符串。 openai/gpt-6.1-sol 换成 openai/gpt-6.1-terra。
  • 推理强度。 GPT-6.1 Terra 还接受 none，GPT-6.1 Sol 不接受；两者默认都是 medium，都支持 low 到 max。Responses 上用 reasoning.effort 设置，Chat Completions 上用 reasoning_effort。OpenAI 建议从 medium 起步，质量提升值得多花的时间和 token 时再调高。
  • 采样参数。 OpenAI 的规则对两者一样：推理强度不为 none 时，去掉 temperature、top_p 和 top_logprobs，Chat Completions 上还要去掉 logprobs；Responses 上要把 message.output_text.logprobs 从 include 里拿掉。GPT-6.1 Terra 默认是 medium，这些参数都不要传；OpenAI 的规则覆盖 none 以外的所有推理强度。
  • 工具调用。 不变：两者的工具调用都只走 Responses API。
  • 知识截止。 按两者的模型页，GPT-6.1 Terra 是 2026 年 6 月 1 日，GPT-6.1 Sol 是 2026 年 4 月 30 日。

从 GPT-5.6 Terra 切过来：

  • model 字符串。 openai/gpt-5.6-terra 换成 openai/gpt-6.1-terra。
  • 工具调用。 OpenAI 的指南写明：应用如果通过 Chat Completions 调用工具，要把这些请求迁到 Responses API。GPT-6.1 Terra 的工具调用只走 Responses API，在 /v1/chat/completions 上发送工具的代码要改走 /v1/responses。
  • 先对比再切换。 OpenAI 建议用同一推理强度，拿有代表性的图片与流程对比两个模型。
  • 推理强度。 两者模型页列出的取值相同：none 到 max，默认 medium。
  • 知识截止。 GPT-6.1 Terra 是 2026 年 6 月 1 日，GPT-5.6 Terra 是 2026 年 2 月 16 日。

GPT-5.6 Terra 仍在目录中：截至 2026-10-28 的模型目录，Router One 照常列出 openai/gpt-5.6-terra，OpenAI 的弃用页（2026-10-28 核对）也没有它的退役安排。

Computer use 与图像输入

OpenAI 的模型页把 computer_use 列为 GPT-6.1 Terra 在 Responses API 上支持的工具之一；按 OpenAI 的 computer use 指南（2026-10-28 核对），这个工具是由你的应用驱动的循环：模型返回 computer_call 项，你的代码在自己提供的环境里执行，再把结果连同截图作为 computer_call_output 发回去，直到任务完成。这是 OpenAI 对自家 API 的说明。本文不对经 Router One 运行 computer use 循环作任何承诺；要依赖它，先用自己的 Key 测一遍。

目录为 openai/gpt-6.1-terra 列出了文本与图像输入，OpenAI 提到的视觉任务——商品照片、技术图纸、应用界面——都离不开图像：请求里的图片，或 computer use 循环里回传的截图。OpenAI 的 GPT-6 指南把视觉分析指向它的图像输入指南，把在界面上操作指向 computer use 指南。

费用怎么算

模型页上有两行单价，适用哪一行由单次请求的输入 token 总数决定。输入恰好 272,000 token 时仍按标准线；严格超过之后，整次请求——包括输出——都按长上下文线计费，而不是只对超出门槛的部分加价；月度用量不参与判断。按 OpenAI 的模型页（2026-10-28 核对），输入超过 272K token 的请求，整单按 2 倍的输入与缓存价格、1.5 倍的输出价格计价；Router One 的长上下文价格线与这条规则对齐。

Agent 循环每一轮都会重发越来越长的对话，单次输入一旦越过 272,000 token，从这一轮起每个请求都按长上下文线计费，直到上下文重新回到门槛以下；所以长会话里大多数请求落在哪一行，取决于客户端的压缩设置。

推理输出按模型公示的输出单价计费，没有单独的推理价格行（价格事实页），所以推理强度既是质量旋钮，也是成本旋钮；GPT-6.1 Terra 的推理强度可以一直调到 none。模型页还列有缓存输入的价格行；怎么从 usage 里读缓存计数、避免把输入算两遍，见 Prompt 缓存指南；长上下文计价规则的完整说明在计价方法，成本计算器会按请求套用它。

本文不印每 token 单价，因为它会过时。实时单价看 GPT-6.1 Terra 模型页，上面的对比页会渲染它与 GPT-6.1 Sol、GPT-5.6 Terra 之间的价差。

订阅套餐覆盖 GPT-6.1 Terra 吗？

不覆盖。截至 2026-10-28 的套餐接口，GPT-6.1 Terra 不在 Pro、Max、Ultra 的任何档位，无论是否订阅，它的调用都按公示单价从钱包按 token 扣费。按同一套餐接口，GPT-6.1 Sol 在三个套餐的「高级模型」档，GPT-5.6 Terra 在三个套餐的「中级模型」档，GPT-6 Astra 在 Max 与 Ultra 的「旗舰模型」档。套餐的模型列表会调整，实时列表和各套餐额度以价格页为准。

发出第一个请求

  1. 创建 Key。 控制台 → API 密钥 → 创建密钥，Key 形如 sk-...。试用阶段给这把 Key 设一个 maxSpend 消费上限。每把 Key 的消费上限（maxSpend）限的是这把 Key 能从钱包扣的钱：累计扣费到上限后，这把 Key 上需要钱包付费的请求返回 HTTP 402。套餐额度覆盖的请求从账户共用的套餐额度里扣，不计入任何 Key 的上限。其他 Key 照常可用（按 Key 成本追踪）。
  2. 准备钱包余额。 截至 2026-10-28 的套餐接口，不论是否订阅，GPT-6.1 Terra 的调用都从钱包扣费——充值在控制台 → 充值，支持支付宝或银行卡。
  3. 设置 base URL：在任意 OpenAI 兼容 SDK 或客户端里填 https://api.router.one/v1。
  4. 调用模型。 下面的示例都用目录 id openai/gpt-6.1-terra，并显式设置输出上限。

Responses，显式设置推理强度（厂商默认为 medium）：

bash
curl https://api.router.one/v1/responses \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-6.1-terra",
    "reasoning": {"effort": "medium"},
    "max_output_tokens": 25000,
    "input": "把这条更新日志改写成一句面向用户的大白话：修复了令牌刷新时的竞争问题，该问题会导致偶发的 401。"
  }'

工具调用走这个端点。Responses 格式的函数工具示例：

bash
curl https://api.router.one/v1/responses \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-6.1-terra",
    "reasoning": {"effort": "low"},
    "max_output_tokens": 25000,
    "tools": [{
      "type": "function",
      "name": "get_order_status",
      "description": "Look up the status of an order by its id.",
      "parameters": {
        "type": "object",
        "properties": {"order_id": {"type": "string"}},
        "required": ["order_id"]
      }
    }],
    "input": "订单 8812 现在到哪了？"
  }'

输出里出现 function_call 项时，执行这个函数，再把结果作为带同一个 call_id 的 function_call_output 项发回去。

Chat Completions，给发这种请求的客户端用——不带工具，因为 OpenAI 模型页写明工具调用必须走 Responses API：

bash
curl https://api.router.one/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-6.1-terra",
    "max_tokens": 25000,
    "messages": [{"role": "user", "content": "把这条更新日志改写成一句面向用户的大白话：修复了令牌刷新时的竞争问题，该问题会导致偶发的 401。"}]
  }'

用 OpenAI Python SDK 发同样的 Responses 请求，只需要改 base_url 和 Key：

python
from openai import OpenAI

client = OpenAI(
    base_url="https://api.router.one/v1",
    api_key="sk-your-api-key",
)

response = client.responses.create(
    model="openai/gpt-6.1-terra",
    reasoning={"effort": "medium"},
    max_output_tokens=25000,
    input="把这条更新日志改写成一句面向用户的大白话：修复了令牌刷新时的竞争问题，该问题会导致偶发的 401。",
)
print(response.status, response.output_text)
print(response.usage)

两个端点通用的几条规则：

  • 每个请求都设置输出上限。 推理 token 计入输出上限；OpenAI 建议起步时为推理与输出预留至少 25,000 token（reasoning 指南，2026-10-28 核对）。在 Responses API 上，按同一份指南，达到上限的响应会以 status: "incomplete" 返回，可能连可见文字都还没有输出。在 Router One 的 Chat Completions 上，max_tokens 与 max_completion_tokens 都可以设定这个上限（两者同时传入时以 max_completion_tokens 为准）；Responses API 上用 max_output_tokens。
  • 不传采样参数。 不要传 temperature、top_p、top_logprobs 或 logprobs：OpenAI 的规则覆盖 none 以外的所有推理强度，原因见上文。
  • 长任务用流式。 stream: true 让输出边生成边返回，两个端点都可以用（流式输出指南）。
  • 不要发到 /v1/messages。 把这个 id 发到那里，会在调用任何模型之前返回 HTTP 400，错误信息会写明该模型必须通过 /v1/chat/completions 调用。各系列的端点规则见 API 兼容性事实页。
  1. 看 Trace。 控制台 → 日志里每次调用都带模型、输入输出 token、费用、延迟和状态（每请求可观测）。可重试的上游故障由同一模型多条候选线路之间的自动故障转移消化；GPT-6.1 Terra 的请求绝不会被换成别的模型来回答。

其他编程工具

编程 agent 几乎每一轮都会带上工具，而按 OpenAI 的 GPT-6.1 Terra 模型页（2026-10-28 核对），它的工具调用必须走 Responses API，所以用它跑 agent 任务需要发 Responses 请求的客户端。把工具指向它之前，先确认那个工具发的是哪种协议：各工具的请求路径见 GPT-6 Sol 接入 Codex CLI、Cursor、Cline 与 OpenCode 里的工具表。Claude Code 调不了 GPT-6.1 Terra：它发的是 Anthropic Messages 请求，而 /v1/messages 只服务 Claude 系列与 DeepSeek id。按 openai/codex 源码（rust-v0.165.0，2026-10-28 核对），Codex CLI 0.165.0 把 gpt-6.1-terra 加进了内置模型列表；Codex 0.159.1 起在 config.toml 没写 model 时使用的默认模型仍是 gpt-6.1-sol。

国内怎么用

中国大陆可直连 api.router.one，无需 VPN，Key 和 base URL 与海外完全一致。充值可用支付宝或银行卡在同一个托管收银台完成，也支持 6 条链上的 USDT/USDC（Tron、BSC、以太坊、Polygon、Base、Arbitrum），无需美国信用卡。调用 GPT-6.1 Terra 不需要 ChatGPT 订阅，也不需要 OpenAI 账号；实时单价看它的模型页。Codex CLI 的国内配置见 Codex CLI 国内使用。

常见问题

Router One 上 GPT-6.1 Terra 的模型 ID 是什么？ openai/gpt-6.1-terra，截至 2026-10-28 的模型目录已列出；/v1/responses 与 /v1/chat/completions 都用这个 ID。GPT-5.6 Terra（openai/gpt-5.6-terra）是更早的另一个模型，截至 2026-10-28 的模型目录同样列出。截至 2026-10-28 的套餐接口，GPT-6.1 Terra 不在任何套餐档位，调用按 token 从钱包扣费。

Router One 的订阅套餐包含 GPT-6.1 Terra 吗？ 不包含。截至 2026-10-28 的套餐接口，GPT-6.1 Terra 不在 Pro、Max、Ultra 的任何档位，订阅用户调用它也从钱包扣费。按同一套餐接口，GPT-6.1 Sol 在三个套餐的「高级模型」档，GPT-5.6 Terra 在「中级模型」档。实时的套餐模型列表见价格页。

选 GPT-6.1 Terra 还是 GPT-6.1 Sol？ OpenAI 把 GPT-6.1 Terra 定位为 "fast and efficient"（快速高效），把 GPT-6.1 Sol 定位为 "balanced speed, cost, and intelligence"（速度、成本与智能兼顾）（GPT-6 指南，2026-10-28 核对），它的模型选择指南建议用相同输入和推理强度对比两者。按 OpenAI 的说法，两者的工具调用都只走 Responses API，只有 GPT-6.1 Terra 接受 none 推理强度。在 Router One 上计费不同：截至 2026-10-28 的套餐接口，GPT-6.1 Sol 计入 Pro、Max、Ultra 的「高级模型」额度，GPT-6.1 Terra 不在任何套餐档位、按钱包计费。GPT-6.1 Terra vs GPT-6.1 Sol 对比页会并排渲染实时单价。

GPT-6.1 Terra 能在 Chat Completions 上做工具调用吗？ 按 OpenAI 的说法不能：它的 GPT-6.1 Terra 模型页（2026-10-28 核对）写明工具调用必须走 Responses API，GPT-6 指南也写明：GPT-6.1 Terra 支持 Chat Completions，工具调用则只走 Responses。带工具的请求请发到 /v1/responses，Chat Completions 留给不带工具的请求；为 GPT-5.6 Terra 写的、在 Chat Completions 上发送工具的代码要迁走。

GPT-6.1 Terra 接受哪些推理强度？ 按 OpenAI 的模型页（2026-10-28 核对）：none、low、medium（默认）、high、xhigh 与 max。OpenAI 的 GPT-6 指南建议从 medium 起步，质量提升值得多花的时间和 token 时再调高。推理强度不为 none 时，OpenAI 要求去掉 temperature、top_p 与 top_logprobs（Chat Completions 上还有 logprobs）。推理 token 按输出计费，所以推理强度也是成本旋钮。

单次输入超过 272K token，为什么更贵？ 因为模型页有两行单价，单次请求的总输入一旦严格超过 272,000 token，整次请求——包括输出，而不只是超出门槛的部分——都改按长上下文线计费。输入恰好 272,000 token 时按标准线，月度用量不影响适用哪一行。按 OpenAI 的模型页（2026-10-28 核对），OpenAI 对自家 API 也是这样计价：输入超过 272K token 的请求，整单按 2 倍的输入与缓存价格、1.5 倍的输出价格计费。

Codex CLI 里有 GPT-6.1 Terra 吗？ 有，Codex CLI 0.165.0 起的内置模型列表收录了它。按 openai/codex 源码（rust-v0.165.0，2026-10-28 核对），这份列表里有 gpt-6.1-terra 这一条；Codex 0.159.1 起在 config.toml 没写 model 时使用的默认模型仍是 gpt-6.1-sol。OpenAI 的 Codex 模型页（2026-10-28 核对）写的是 GPT-6.1 Terra 需要 Codex CLI 0.159.0 或更高版本；接 Router One 这类自定义 model provider 时，Codex 默认只从内置列表里取模型设置，所以 0.165.0 之前的版本会按通用的回退设置运行这个名字。截至 2026-10-28 的套餐接口，GPT-6.1 Terra 不在任何套餐档位，调用按公示单价从钱包扣费。

没有 GPT-6 Terra 吗？ 按 OpenAI 的模型目录（2026-10-28 核对），没有 GPT-6 Terra 条目；它的 GPT-6 指南列出的 Terra 模型是 GPT-6.1 Terra。截至 2026-10-28 的模型目录，Router One 列出 GPT-6.1 Terra（openai/gpt-6.1-terra）和更早的 GPT-5.6 Terra（openai/gpt-5.6-terra），以实时目录 /models 为准。

Claude Code 能调用 GPT-6.1 Terra 吗？ 不能。Claude Code 向 /v1/messages 发送 Anthropic Messages 请求，这个端点只服务 Claude 系列与 DeepSeek id；GPT id 发过去会在调用任何模型之前返回 HTTP 400。

调用 GPT-6.1 Terra 需要 ChatGPT 订阅吗？ 不需要。Router One 按你的 Router One 钱包对 API 调用计费，国内直连，支付宝或银行卡即可充值。按 OpenAI 的 Codex 更新日志（2026-10-26 条目，2026-10-28 核对），ChatGPT 里的 GPT-6.1 Terra 面向 Plus、Pro、Business、Enterprise 与 Edu 套餐，只在 ChatGPT Work 与 Codex 中提供，Chat 里没有；ChatGPT 套餐与经 Router One 发出的 API 调用无关。

下一步

相关权威页面

这篇文章归入「Codex CLI 中国」主题，以下页面作为商业页、配置文档、证据页和信任事实源。

商业主页面Codex CLI 中国主页面承接 Codex CLI 接入、OpenAI 兼容配置、钱包计费和预算控制。GPT 单价更低成本调用 GPT APIGPT 系列的公示 token 单价，以及钱包按量计费怎么扣。协议说明Codex 与 Responses API为什么 Codex 在只支持 Chat Completions 的中转上 404，以及可用的 config.toml。配置文档Codex CLI 配置用 OpenAI 兼容 Base URL 和 Router One API Key 配置 Codex CLI。证据页价格方法论说明钱包价格、token 计量、汇率处理和成本传导方式。信任页安全边界API Key、请求元数据和账户访问的安全控制说明。数据留存数据留存政策说明直接 API 的元数据记录与 Playground 会话历史的区别，以及删除申请边界。

相关阅读

GPT-6 Astra API 接入指南：国内调用、Codex 与套餐

GPT-6 Astra 国内直连调用：模型 ID、工具调用按 OpenAI 文档只走 Responses API、Codex 配置，以及只有 Max 与 Ultra 套餐才有的旗舰模型额度（Pro 按钱包计费）。

查看

GPT-6.1 Sol API 接入指南：国内调用、Codex 与套餐

GPT-6.1 Sol 国内直连调用：模型 ID、两个端点、工具调用按 OpenAI 文档只走 Responses API，套餐额度还是钱包计费，附 Codex 默认模型变化与迁移要点。

查看

GPT-6 Sol API 接入指南：端点、272K 价格阶梯与国内调用

GPT-6 Sol 经 Router One 调用：目录 id、1.05M 上下文、272K 整单阶梯、套餐是否覆盖、Chat Completions 与 Responses 示例、Codex CLI 配置、国内直连。

查看