GPT-6.1 Terra：Vercel AI Gateway 接入配置

一句话结论

在 Vercel AI Gateway 中，GPT-6.1 Terra 的模型名是 openai/gpt-6.1-terra；可通过 Vercel AI SDK、OpenAI 兼容的 Chat Completions API、Responses API 或已连接 Gateway 的编码 Agent 调用。Gateway 统一提供用量与成本追踪、重试、故障切换和路由配置。

适用场景

• 适合的任务：将 GPT-6.1 Terra 接入 Vercel AI Gateway；从 AI SDK、OpenAI 兼容接口或编码 Agent 发起请求；集中管理模型用量和路由。

• 不适合的任务：用这篇发布说明推断 SDK 的全部参数、Responses API 请求格式或具体路由规则；原文未提供这些完整配置。

• 适用的模型版本：GPT-6.1 Terra。标准模型名为 openai/gpt-6.1-terra；延迟敏感时可选择 openai/gpt-6.1-terra-fast。

• 适用的客户端、Agent 或 API：Vercel AI SDK、OpenAI 兼容的 Chat Completions API、Responses API、连接 AI Gateway 的 Codex、Cursor 等编码 Agent；原文还提供 fx 的连接步骤。

• 推荐的推理档位和参数：原文说明支持配置 reasoning effort，但未列出可选档位或推荐值。以下 API 示例使用流式输出；示例提示词用于演示提案起草。

可直接使用的内容

Vercel AI SDK

以下代码保留自原文 API 示例：

import { streamText } from 'ai';

const result = streamText({
  model: 'openai/gpt-6.1-terra',
  prompt: 'Draft a one-page proposal for migrating our docs site to Next.js.',
});

OpenAI 兼容的 Chat Completions API

原文示例使用 Python OpenAI SDK，将 base_url 指向 AI Gateway，并从环境变量读取 Gateway API key：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["AI_GATEWAY_API_KEY"],
    base_url="https://ai-gateway.vercel.sh/v1",
)

stream = client.chat.completions.create(
    model="openai/gpt-6.1-terra",
    messages=[{"role": "user", "content": "Draft a one-page proposal for migrating our docs site to Next.js."}],
    stream=True,
)

for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="", flush=True)

Codex 接入

原文给出两种选择方式：运行 Vercel CLI 自动检测 Agent、创建 Gateway API key 并写入配置，然后在 Codex 中运行 /model 选择 GPT-6.1 Terra；或直接以该模型启动：

npx vercel@latest ai-gateway setup
codex --model openai/gpt-6.1-terra

fx 接入

原文列出的连接步骤与模型选择命令：

curl -fsSL https://fx.sh/setup.sh | bash
fx

在 fx 中运行 /setup，选择使用 Vercel 登录或粘贴 AI Gateway key；然后运行：

/model openai/gpt-6.1-terra

测试或工作流步骤

1. 选择集成方式：AI SDK、OpenAI 兼容 Chat Completions、Responses API 或编码 Agent。按对应客户端文档准备 AI Gateway 凭证；原文只在 Chat Completions 代码中明确使用 AI_GATEWAY_API_KEY 环境变量。

2. 将模型名设为 openai/gpt-6.1-terra。如任务优先考虑延迟，评估 openai/gpt-6.1-terra-fast。

3. 使用代表性请求验证模型输出，并在 Gateway 中检查用量和成本。原文发布页未提供基准结果或质量、延迟保证。

4. 如需统一处理可用性或性能，可在 Gateway 中配置 retries、failover、routing rules 等能力；具体选项按 AI Gateway 文档和账户配置为准。

flowchart LR
  A[选择 SDK、API 或 Agent] --> B[配置 AI Gateway 凭证]
  B --> C[选择 openai/gpt-6.1-terra]
  C --> D[发送代表性请求]
  D --> E[检查输出、用量与成本]
  E --> F[按需配置重试、故障切换和路由]

原始证据与数据

• 发布页给出的标准模型标识为 openai/gpt-6.1-terra，快速模式标识为 openai/gpt-6.1-terra-fast。

• 发布页列出 AI SDK、OpenAI 兼容 Chat Completions API、Responses API，以及连接 AI Gateway 的编码 Agent 作为接入方式，并展示了 AI SDK JavaScript 和 Chat Completions Python 示例。

• Codex 示例建议先执行 npx vercel@latest ai-gateway setup；之后可运行 /model 选择 GPT-6.1 Terra，或使用 codex --model openai/gpt-6.1-terra 启动。

• Gateway 功能说明包括统一调用模型、追踪用量和成本、配置 retries、failover、performance optimizations 和 routing rules。页面还提到 custom reporting、Zero Data Retention 支持和 API key budgets。

• 页面称 Gateway 按提供商价格计费，不加价，推理不收平台费；该说明也适用于 BYOK 请求。

• 模型说明为文本和图像输入、文本输出、超过 1M tokens 的上下文窗口；支持可配置 reasoning effort、structured outputs、tool calling，以及隐式和显式 prompt caching。

适用边界

• 这是 Vercel 对 AI Gateway 接入方式与模型标识的官方发布说明，不是 GPT-6.1 Terra 的独立测评，也未提供任务级质量、延迟或成本数据。

• 原文示例中的英文 prompt 是 Vercel 用于演示调用的输入，不是 GPT-6.1 Terra 专属提示词或完整提示词模板。

• 页面只概述 Responses API 可用，没有给出其请求代码；推理档位的可选值也未在该页面列出。

• Gateway 的重试、故障切换和路由功能只在发布页作概述，未包含详细规则语法或配置示例。AI Gateway 的接入模型名和 URL 属于 Vercel 路径，不应替换为 OpenAI 原生 API 配置。

• 发布页日期为 2026-10-26；价格、功能和模型目录可能变化，使用前应查看当前 Vercel 文档。

复现说明

在 Tabbit 浏览器打开原文页，核对发布日期、模型标识、集成方式、AI SDK 与 Chat Completions 代码示例、Codex/fx 的接入步骤及 Gateway 功能说明。页面正文和示例均可完整读取；采集日期为 2026-10-27。