GPT-6.1 Terra API 怎么用：官方定位、Codex 目录与 QCode 接法
截至 2026-11-05，OpenAI 官方 changelog 写明 GPT-6.1 Terra（gpt-6.1-terra）于 2026-10-26 发布，Responses 与 Chat Completions 两个接口都能调用；Codex 0.166.0（2026-10-29）已把它加进内置模型目录。QCode 的 /models 与 docs 都列有 gpt-6.1-terra，接法见下文。
更新于 2026-11-05
Claude、GPT 与国产模型共用一把 key，按 token 计费；可调型号以 /models 为准。
- 按 token 计费，实时单价见 /models
- 支付宝、微信支付、信用卡、加密货币均可付款
- 充值后自助开通、立刻生效
GPT-6.1 Terra 要点
官方定位
OpenAI 模型页的原句是 “A fast, efficient model for visual reasoning, precise computer use, and clear, natural writing.”：快速、高效，面向视觉推理、精确的电脑操作和清晰自然的写作。
上下文窗口（tokens）
官方模型页：最大输入 922,000 tokens，最大输出 128,000 tokens，知识截止 2026-06-01；输入支持文本与图像，输出为文本。
QCode 的两个 OpenAI 端点
Codex（Responses 协议）的 base_url 填 https://api.qcode.cc/openai，用 OpenAI SDK 走 Chat Completions 填 https://api.qcode.cc/openai/v1，均为 QCode docs 原值；官方写明工具调用需要 Responses API。
Codex 内置目录
Codex CLI rust-v0.166.0 的 release notes（2026-10-29 发布）写有 “Added GPT-6.1 Terra to the bundled, Vertex AI, and Amazon Bedrock model catalogs.”
GPT-6.1 Terra 是什么，和 GPT-6.1 Sol 差在哪
截至 2026-11-05，GPT-6.1 Terra 是 OpenAI 在 2026-10-26 发布的 API 型号，官方 changelog 把它描述为快速、高效、面向视觉推理的型号，模型 ID 是 gpt-6.1-terra。官方模型页给的用法举例是：把商品图与目录条目对应起来、读技术图纸、在应用界面上执行操作、起草和修改文本。同一代的 GPT-6.1 Sol 在官方页的定位是“接近 Astra 的表现、成本更低”，用于复杂编码、电脑操作和专业工作；两者的上下文窗口、最大输入和最大输出数字相同，知识截止不同（Terra 为 2026-06-01，Sol 为 2026-04-30），reasoning.effort 的可选档位也不同（Terra 多一档 none）。
官方与 QCode 现况（2026-11-05 核对）
OpenAI 的 gpt-6.1-terra 模型页列有官方价格，并写明缓存输入价是未缓存输入价的 5%；各型号价目见 OpenAI pricing 页（developers.openai.com/api/docs/pricing）。QCode 的 /models 把 gpt-6.1-terra 标为 NEW，窗口显示 922K / 128K；docs 的 Codex 页把它写成 GPT-6.1 中档，推荐场景是日常编码与批量任务。
时间线
OpenAI API changelog 发布 GPT-6.1 Terra（gpt-6.1-terra），并指向 GPT-6 guide 的提示词与迁移说明。
Codex CLI rust-v0.166.0 发布，内置目录加入 GPT-6.1 Terra，Vertex AI 与 Amazon Bedrock 目录同步加入。
核对 QCode 的 /models 与 docs 的 Codex 页：两处都列有 gpt-6.1-terra。
官方写明的与官方未公布的
已确认（官方页逐字可核）
① 2026-10-26 发布，模型 ID 为 gpt-6.1-terra，默认快照同名；② Realtime 与 Fine-tuning 端点官方标为不支持，音频与视频模态也不支持；③ 支持推理 token、流式输出、结构化输出、函数调用和提示缓存；④ 超过 272K 输入 tokens 的请求，整次按 2 倍输入与缓存单价、1.5 倍输出单价计。
官方未公布的部分
官方 changelog、模型页和 Codex 0.166.0 的 release notes 都没有给出 Terra 的跑分，也没有说明它是否会成为 Codex 的默认模型；以上截至 2026-11-05 官方均未公布。
Terra 与 Sol 怎么选
gpt-6.1-sol
官方定位：接近 Astra 的表现、成本更低，用于复杂编码、电脑操作和专业工作；官方页的 reasoning.effort 为 low 到 max；知识截止 2026-04-30。
gpt-6.1-terra
官方定位：快速、高效，面向视觉推理、精确的电脑操作和清晰自然的写作；reasoning.effort 为 none、low、medium（默认）、high、xhigh、max；知识截止 2026-06-01。官方价格见 OpenAI pricing 页，QCode 单价见 /models。
怎么调用 GPT-6.1 Terra
① 选接口：官方写明 Chat Completions 与 Responses 都支持 gpt-6.1-terra，需要工具调用时用 Responses。② 在 Codex 里：照 QCode docs 的 Codex 页写 ~/.codex/config.toml，顶层写 model_provider = "qcode" 与 model_reasoning_effort = "high"，[model_providers.qcode] 里写 name = "qcode"、base_url = "https://api.qcode.cc/openai"、wire_api = "responses"、requires_openai_auth = true；docs 示例里是 model = "gpt-6.1-sol"，要用 Terra 就把示例里的这一行改为 model = "gpt-6.1-terra"（docs 的型号表列有该型号）。cr_ 开头的 QCode 密钥写进 ~/.codex/auth.json 的 OPENAI_API_KEY。只想临时切换时，把 docs 示例 codex -m 后面的型号换成 gpt-6.1-terra。③ 用 OpenAI SDK 走 Chat Completions：base_url（或环境变量 OPENAI_BASE_URL）设为 https://api.qcode.cc/openai/v1。
在 QCode 上用 GPT-6.1 Terra
三步：注册并创建 cr_ 开头的密钥；充值，支持支付宝、微信支付、银行卡（Visa · Mastercard · Apple Pay · Google Pay）和加密货币；把上面的 base_url 或 OPENAI_BASE_URL 填好，model 写 gpt-6.1-terra。GPT 只走 OpenAI 的两个端点，不能走 Anthropic 端点。按 token 计费，各模型单价见 /models。不想包月？按量包 ¥26 起买一笔额度，7 天内用完为止；已有个人套餐的用户额度不够时买加油包。
常见问题
GPT-6.1 Terra 适合什么任务？
官方模型页给的例子是：把商品图与目录条目对应起来、读技术图纸、在应用界面上执行操作、起草和修改文本。复杂编码、电脑操作和专业工作，是官方给 GPT-6.1 Sol 写的用途。
GPT-6.1 Terra API 价格是多少？
以 OpenAI 官方 pricing 页（developers.openai.com/api/docs/pricing）和 gpt-6.1-terra 模型页列出的价格为准；超过 272K 输入 tokens 的请求整次按 2 倍输入与缓存单价、1.5 倍输出单价计。QCode 按 token 计费，各模型单价见 /models。
Codex 里能选 GPT-6.1 Terra 吗，默认模型是不是 Terra？
能。Codex CLI 0.166.0（2026-10-29）的 release notes 写明已把 GPT-6.1 Terra 加进内置模型目录。默认模型是否改成 Terra，官方 release notes 没有写，截至 2026-11-05 未公布。
GPT-6.1 Terra 和 GPT-5.6 Terra 是什么关系？
是两个不同的模型 ID：gpt-6.1-terra 与 gpt-5.6-terra。QCode docs 把前者写成 GPT-6.1 中档，把后者写成 GPT-5.6 旗舰、代码优化；GPT-5.6 三档的对照见 /gpt-5-6-sol-vs-terra-vs-luna。
GPT-6.1 Terra 在 QCode 上怎么调用？
用 QCode 的密钥，Codex 填 base_url https://api.qcode.cc/openai（wire_api 为 responses），Chat 端点是 https://api.qcode.cc/openai/v1，model 写 gpt-6.1-terra；是否在售以 /models 为准。
国内怎么充值才能用 GPT-6.1 Terra？
QCode 支持支付宝、微信支付、银行卡（Visa · Mastercard · Apple Pay · Google Pay）和加密货币；支付宝、微信支付、银行卡通常 1 分钟内到账，加密货币为人工核对、1 天内到账。完整的 GPT-6 充值说明见 /gpt-6-api-china-top-up。
信息来源
OpenAI 官方：API changelog、gpt-6.1-terra 与 gpt-6.1-sol 模型页（developers.openai.com），Codex CLI rust-v0.166.0 release notes（GitHub），均在 2026-11-05 抓取。QCode 侧：qcode.cc/models、docs.qcode.cc 的 Codex 页与端点说明、充值页，同日抓取。
相关阅读
按量包
不包月，一次买一笔额度，7 天有效；续买额度累加到同一把 Key。
GPT-6 指南
GPT-6 一代各型号的发布时间、规格与 QCode 可调型号。
GPT-5.6 三档区别
GPT-5.6 Sol、Terra、Luna 的对照与默认选择。
加密货币充值指南
9 种币、56 条网络，0 平台手续费购买 AI 编程 API 额度。
本页事实核对于 2026-11-05，以 OpenAI 官方页面和 QCode 官方文档为准；模型可用性以 /models 为准，OpenAI 调整时不另行通知。