GPT-6.1 Terra：OpenRouter 路由与 API 配置

一句话结论

OpenRouter 上的模型 ID 是 openai/gpt-6.1-terra，可通过 OpenRouter SDK 或兼容 Chat Completions 的 HTTP API 调用；可用请求体中的 provider 对候选提供商排序、限制或过滤。默认路由会综合近期可用性与价格进行负载均衡。

适用场景

• 适合的任务：通过 OpenRouter 接入 GPT-6.1 Terra；在单一 API 中选择提供商路由策略；按价格、吞吐量或延迟排序候选端点。

• 不适合的任务：据此推断 OpenAI 原生 API 的地址、密钥或路由参数；把 OpenRouter 的性能排序当作服务等级保证。

• 适用的模型版本：OpenRouter 模型页列出的 GPT-6.1 Terra，ID 为 openai/gpt-6.1-terra。

• 适用的客户端、Agent 或 API：OpenRouter TypeScript SDK、HTTP Chat Completions API；模型页也列出 Responses API 与 Anthropic Messages API 兼容端点。

• 推荐的推理档位和参数：按任务选择 reasoning.effort；OpenRouter 文档列出的通用值为 max、xhigh、high、medium、low、minimal、none。模型是否支持特定档位应以模型元数据和实际请求结果为准。路由示例使用 provider.sort: "throughput"。

可直接使用的内容

准备 API Key

在 OpenRouter 控制台创建 API Key，并存入环境变量：

export OPENROUTER_API_KEY="sk-or-v1-..."

TypeScript SDK：流式调用

以下是模型页提供的 SDK 调用方式，模型 ID 与示例中的用户消息替换为所需内容：

import { OpenRouter } from "@openrouter/sdk";

const openrouter = new OpenRouter({
  apiKey: process.env.OPENROUTER_API_KEY!,
});

const stream = await openrouter.chat.send({
  chatRequest: {
    model: "openai/gpt-6.1-terra",
    messages: [{ role: "user", content: "Hello" }],
    stream: true,
  },
});

for await (const chunk of stream) {
  const content = chunk.choices[0]?.delta?.content;
  if (content) process.stdout.write(content);
}

HTTP API：按吞吐量排序

OpenRouter 的 Provider Selection 文档给出 provider.sort 配置。将其与 Terra 模型 ID 组合后，可用以下 Chat Completions 请求优先尝试吞吐量较高的提供商：

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-6.1-terra",
    "messages": [{"role": "user", "content": "Hello"}],
    "provider": {"sort": "throughput"},
    "stream": false
  }'

如需按价格或延迟排序，将 throughput 分别改为 price 或 latency。设置 provider.sort 后，路由器会按排序后的端点顺序尝试；默认按价格负载均衡的行为会关闭。

可配置推理参数

OpenRouter 对支持推理的模型提供统一的 reasoning 参数。示例档位须先核对该模型支持的值：

{
  "model": "openai/gpt-6.1-terra",
  "messages": [{"role": "user", "content": "Hello"}],
  "reasoning": {"effort": "medium"},
  "max_tokens": 4096
}

模型页列出的请求参数还包括 seed、response_format、tools、tool_choice 和 verbosity。max_tokens 限制生成上限；推理 token 在多数提供商处也计入该上限和输出计费，预算应留出可见回答所需空间。

测试或工作流步骤

1. 在 OpenRouter 创建 API Key，并设置 OPENROUTER_API_KEY。

2. 使用模型 ID openai/gpt-6.1-terra 发送一条基础 Chat Completions 请求。

3. 需要按性能或费用选路时，在 provider.sort 中选 throughput、latency 或 price；需要固定提供商时，使用 provider.only 或 provider.order，并按需设置 allow_fallbacks。

4. 仅在模型支持时设置 reasoning.effort；合理设置 max_tokens，然后检查响应、用量和实际计费。

flowchart LR
  A[创建 OpenRouter API Key] --> B[设置 OPENROUTER_API_KEY]
  B --> C[请求 openai/gpt-6.1-terra]
  C --> D{需要指定路由偏好?}
  D -- 否 --> E[使用默认负载均衡]
  D -- 是 --> F[设置 provider.sort 或提供商筛选]
  E --> G[检查响应与用量]
  F --> G

原始证据与数据

• OpenRouter 模型页标示模型名为 OpenAI: GPT-6.1 Terra、ID 为 openai/gpt-6.1-terra；页面列出的输入/输出价格为每百万 token $1 / $5，上下文为 1.1M，发布日期为 2026-10-26。价格与目录信息会变化。

• 模型页 API 面板提供 OpenRouter SDK、Python、TypeScript fetch、cURL、Python OpenAI SDK 和 TypeScript OpenAI SDK 等标签；其 TypeScript SDK 示例使用 openrouter.chat.send、chatRequest、上述模型 ID 和流式响应。

• API 面板列出 Chat Completions、Responses API、Anthropic Messages API 端点。Chat Completions 地址为 https://openrouter.ai/api/v1/chat/completions，认证头为 Authorization: Bearer $OPENROUTER_API_KEY。

• 模型页列出的参数有 reasoning、seed、max_tokens、response_format、tools、tool_choice 和 verbosity。

• Provider Selection 文档列出 provider.order、allow_fallbacks、require_parameters、data_collection、zdr、only、ignore、quantizations、sort、preferred_min_throughput、preferred_max_latency 和 max_price 等路由字段；默认路由综合近期可用性与价格选择提供商。

• Reasoning Tokens 文档说明 reasoning.effort 的通用值、reasoning.max_tokens 与 reasoning.exclude 等选项，以及推理 token 对 max_tokens 和计费的影响。

适用边界

• OpenRouter 上的模型 ID、API 地址和 provider 参数属于 OpenRouter 接入配置，不能替换成 OpenAI 原生 API 地址或直接推断为 OpenAI 原生接口支持的字段。

• provider.sort 是跨提供商的排序偏好，不保证实际延迟、吞吐量或价格；提供商可用性和排序结果会随时间变化。

• 模型页列出 reasoning 参数，但未在页面中列出 Terra 的具体支持档位；文中的 medium 仅是格式示例，使用前应核对模型元数据或请求结果。

• 模型页同时显示 Responses 和 Anthropic Messages 端点，但本文的可直接使用 HTTP 示例只覆盖 Chat Completions；其他端点应按 OpenRouter 对应 API 文档配置。

• OpenRouter 页面显示的价格、上下文和提供商信息是采集时的页面数据，不构成长期承诺。

复现说明

在 Tabbit 浏览器打开模型页，查看 API 面板，核对模型 ID、SDK 示例、端点和参数；再打开 OpenRouter 的 Provider Selection 与 Reasoning Tokens 文档，核对路由字段、默认策略和推理参数。采集日期为 2026-10-27。代码中的路由配置按官方文档的请求格式与 Terra 模型 ID 组合。