GPT-6.1 Terra API：价格、参数和 Codex 接入教程

先说结论

GPT-6.1 Terra（gpt-6.1-terra）是 OpenAI 在 2026 年 10 月 26 日发布的 GPT-6 模型，官方定位是视觉推理、精确的电脑操作（computer use）和清楚自然的写作。按价格它排在 GPT-6.1 Sol 和 GPT-6 Luna 中间：活儿主要是看图、看界面、写文字时选它，复杂的写代码任务还是交给 Sol。官方价格是每百万输入 token $1、输出 $5，是 Sol 官方价的一半，上下文 1.05M。在 TeamoRouter 上用同一个模型 ID 调用，按 token 计费、没有订阅（实时价格见价格页）；Codex CLI 0.159.0 及以上版本，在 config.toml 里改一下模型名就能用。

参数一览

来自 OpenAI 模型页：

OpenAI 给的用法示例：把商品照片和商品目录对上、读懂工程图纸、在应用界面上完成操作、起草和修改文字。在 Responses API 里，它支持的内置工具包括 web search、file search、code interpreter、computer use、apply_patch、MCP 和 tool search。

Terra、Sol、Luna、Astra 怎么选

OpenAI 的 GPT-6 指南现在列了四个模型。下表价格是 OpenAI 标准价，单次输入不超过 272K token 的情况。

按 OpenAI 自己的建议来选：

• Terra：输入是图、输出是文字的活儿。看截图和数据看板、对比工程图纸、在应用界面里一步步操作、写方案和文档。OpenAI 的 Codex 文档说它是写作、视觉理解和电脑操作上「快而高效的选择」。
• Sol：复杂的写代码和多步 Agent 任务。OpenAI 的描述是能力接近 Astra、价格更低。
• Luna：抽取、分类、格式转换、结构化总结这类知道「好结果长什么样」、要跑很多遍的任务。
• Astra：最难的端到端任务，质量比成本重要时。

另外，Terra 支持 none 推理档位，GPT-6.1 Sol 和 GPT-6 Astra 不支持。

GPT-6.1 Terra 和 GPT-5.6 Terra 比。 Terra 是 GPT-5.6 Terra 的下一代，官方价每一项都更便宜：每百万输入 $1 对 $2，缓存读取 $0.05 对 $0.20，输出 $5 对 $12。OpenAI 的迁移建议是：用同样的推理档位，拿有代表性的图片和流程把两个模型对比一遍；原来通过 Chat Completions 调工具的请求，改成 Responses API。Codex 不会自动换模型，config.toml 里写的还是 gpt-5.6-terra 的话，要手动改。

价格

单次输入超过 272K token 时，整次请求的输入和缓存按 2 倍、输出按 1.5 倍计价。在 OpenAI 自己的 API 上，Batch 和 Flex 比标准价低 50%，Fast 模式是标准价的 2 倍。

TeamoRouter 同样按 token 计费，没有订阅，实时价格以价格页为准。

在 Codex CLI 里用

OpenAI 要求 Codex CLI 0.159.0 或更高版本才能用 GPT-6.1 Terra。用 codex --version 看版本，不够的话用 npm install -g @openai/codex 更新。

把下面这段写进 ~/.codex/config.toml，TeamoRouter 的 Key 放到环境变量 OPENAI_API_KEY：

model_provider = "teamorouter"
model = "gpt-6.1-terra"
model_reasoning_effort = "medium"

[model_providers.teamorouter]
name = "TeamoRouter"
base_url = "https://api.teamorouter.cn/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

想平时用 Sol、只在部分会话里用 Terra，就保留 model = "gpt-6.1-sol"，需要时用 codex -m gpt-6.1-terra 启动。会话里用 /model 可以切换模型和推理档位。OpenAI 建议从 medium 开始，效果提升值得多花的时间和 token 时再往上调。完整步骤见 Codex CLI 接入教程。

在 OpenCode 里用

OpenCode 通过 OpenAI 兼容的 provider 接 TeamoRouter：在 opencode.json 里加一个 provider，把 sk-teamo- Key 放进环境变量 TEAMOROUTER_API_KEY，在 models 里加上 gpt-6.1-terra：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "teamorouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "TeamoRouter",
      "options": {
        "baseURL": "https://api.teamorouter.cn/v1",
        "apiKey": "{env:TEAMOROUTER_API_KEY}"
      },
      "models": {
        "gpt-6.1-terra": { "name": "GPT 6.1 Terra" },
        "gpt-6.1-sol": { "name": "GPT 6.1 Sol" },
        "gpt-6-luna": { "name": "GPT 6 Luna" }
      }
    }
  }
}

配置完重启 OpenCode，在模型选择里切到 GPT 6.1 Terra。用 OpenCode Desktop 图形界面配置的话，见 OpenCode 接入文档。

同一个 Key、同一个 base_url，在其它支持 OpenAI 兼容供应商的 agent 里也能用：VS Code 里的 Cline、DeepSeek Harness、Cursor。只改模型名，填 gpt-6.1-terra。

直接调用 API

Responses API（要用工具调用就选它）：

curl https://api.teamorouter.cn/v1/responses \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-terra",
    "reasoning": {"effort": "medium"},
    "input": "把这段更新说明改写成面向客户的大白话：..."
  }'

OpenAI Python SDK，带图片：

from openai import OpenAI

client = OpenAI(base_url="https://api.teamorouter.cn/v1", api_key="YOUR_KEY")
resp = client.responses.create(
    model="gpt-6.1-terra",
    input=[{
        "role": "user",
        "content": [
            {"type": "input_text", "text": "列出这张图纸上标注的尺寸和公差。"},
            {"type": "input_image", "image_url": "https://example.com/drawing.png"},
        ],
    }],
)
print(resp.output_text)

本地图片可以改传 base64 data URL，例如 "image_url": f"data:image/png;base64,{b64}"。

Chat Completions 也能传 gpt-6.1-terra，但 OpenAI 只在 Responses API 上支持这个模型的工具调用。沿用旧的请求代码时注意：推理档位不是 none 时，要去掉 temperature、top_p 和 top_logprobs。完整参数见 API 接入文档。

怎么付费

没有订阅，控制台充值余额，按实际用掉的 token 扣费，最低 $5 起充，支持支付宝。同一个 Key 也能调用 Claude、Gemini。

常见问题

ChatGPT 里能用 GPT-6.1 Terra 吗？ OpenAI 在 Plus、Pro、Business、Enterprise 和 Edu 套餐的 ChatGPT Work 和 Codex 里提供 Terra，Chat 里没有。走 API 调用只需要 API Key，不需要 ChatGPT 套餐。

写代码用 Terra 还是 Sol？ 复杂的写代码任务用 Sol。OpenAI 把 Sol 定位成复杂任务上接近 Astra 的能力，把 Terra 定位成写作、视觉理解和电脑操作。如果任务主要是看截图、写文档，正好是 Terra 的强项；Codex 里用 /model 随时切换。

能传图片吗？ 可以，支持文本和图片输入，输出只有文本，不支持音频和视频。OpenAI 建议对照原始材料核对结果，尤其是从图片里读出来的名字、数字和细节。

多少钱？ OpenAI 官方价每百万输入 $1、缓存读取 $0.05、输出 $5；单次输入超过 272K token 时，整次请求输入按 2 倍、输出按 1.5 倍计价。TeamoRouter 的实时价格见价格页。

推理档位选哪个？ 默认 medium，也是 OpenAI 建议的起点；效果提升值得多花的时间和 token 时再调高。和 Sol、Astra 不同，Terra 也支持 none。

Codex 提示找不到模型。 检查 Codex CLI 是否是 0.159.0 或更高版本，config.toml 第一行是不是 model_provider = "teamorouter"，以及启动 Codex 的终端里有没有设置 OPENAI_API_KEY。

相关阅读

• GPT-6.1 Sol API：比 Terra 高一档，适合复杂的写代码任务
• GPT-6 Luna API：GPT-6 最便宜的一档
• GPT-6 Sol API 怎么用：macOS、Windows、Linux 的 config.toml 配置步骤
• Codex CLI 接入教程
• OpenCode 接入文档