GPT-6.1 Terra：Netlify AI Gateway 与 Agent Runners 配置

一句话结论

Netlify 已支持在 AI Gateway 和 Agent Runners 中使用 GPT-6.1 Terra。Netlify Function 可直接用 OpenAI SDK 的 Responses API 和模型 ID gpt-6.1-terra；Netlify 自动注入 Gateway 凭证。Agent Runners 可在模型设置中选择该模型并运行任务。

适用场景

• 适合的任务：在 Netlify Functions 中调用 GPT-6.1 Terra；从 Netlify 项目面板用 GPT-6.1 Terra 运行代码修改或问答任务。

• 不适合的任务：据此推断 GPT-6.1 Terra 专属提示词、推理档位建议、Responses API 的全部参数或 Agent Runner 内部实现。

• 适用的模型版本：GPT-6.1 Terra；Netlify Function 示例使用模型 ID gpt-6.1-terra。

• 适用的客户端、Agent 或 API：Netlify Functions + OpenAI SDK Responses API；Netlify Agent Runners 中的 OpenAI Codex。

• 推荐的推理档位和参数：未注明。Agent Runners 允许按 Agent 设置模型和推理档位；来源未说明 Terra 的推荐值。

可直接使用的内容

在 Netlify Function 中调用

以下为 Netlify 发布说明中的代码示例。函数运行时，Netlify AI Gateway 自动处理 API key 和认证：

import OpenAI from 'openai';

export default async () => {
  const openai = new OpenAI();
  const response = await openai.responses.create({
    model: 'gpt-6.1-terra',
    input: 'Give a concise explanation of how AI works.',
  });
  return Response.json(response);
};

来源还说明，GPT-6.1 Terra 可用于 Scheduled Functions、Background Functions 和 Edge Functions；Netlify 提供缓存、速率限制和认证基础设施。该公告没有列出这些函数类型各自的额外配置代码。

在 Agent Runners 中选择模型

1. 打开 Netlify 项目面板，在 Build with an AI agent 中选择 OpenAI Codex。

2. 打开 Agent 选项并选择 Configure…，选择 GPT-6.1 Terra；如有需要，设置推理档位并保存。模型与档位偏好分别按 Agent 保存，适用于当前用户后续在各项目发起的运行。

3. 输入任务说明及可选的项目上下文。选择 Build 让 Agent 修改代码并生成 Deploy Preview；选择 Ask 只回答项目问题，不修改代码或生成预览。

4. 在项目的 Agent runs 页面查看运行状态、日志和用量；完成后检查 Deploy Preview，再决定是否发布。

Netlify 文档说明，Agent Runners 需要团队启用 AI 功能、可用额度和受支持的团队角色。使用前按当前团队计划和账号权限核对要求。

测试或工作流步骤

flowchart TD
  A[启用 Netlify AI 功能并确认额度] --> B{选择接入方式}
  B -->|Netlify Function| C[使用 OpenAI SDK 与 Responses API]
  C --> D[模型设为 gpt-6.1-terra]
  D --> E[在函数中验证响应]
  B -->|Agent Runner| F[选择 OpenAI Codex]
  F --> G[Configure 中选择 GPT-6.1 Terra]
  G --> H[选择 Ask 或 Build 并提交任务]
  H --> I[检查 Agent Runs 日志与结果]
  I --> J[Build 模式下检查 Deploy Preview]

1. 若使用 AI Gateway，确认项目已部署在 Netlify，并按项目的函数配置添加 OpenAI SDK 依赖；调用代码无需自行设置 AI Gateway API key 或 base URL。

2. 使用上方 Responses API 示例发起一次测试请求，确认函数返回响应。

3. 若使用 Agent Runners，确认团队 AI 功能和额度可用，在个人 Agent 配置中选择 GPT-6.1 Terra。

4. 先用 Ask 模式了解项目或方案；需要修改文件时使用 Build 模式，查看运行日志和 Deploy Preview。

原始证据与数据

• Netlify 发布说明日期为 2026-10-26，正文明确称 OpenAI GPT-6.1 Terra 已可用于 Netlify AI Gateway 和 Agent Runners。

• 发布说明的 Responses API 代码将 model 设为 gpt-6.1-terra，并使用 new OpenAI()，未传入 API key 或 base URL。

• 发布说明说明 AI Gateway 自动处理 API key 与认证；并列出 Scheduled Functions、Background Functions 和 Edge Functions 支持。

• Netlify Agent Runners 文档列出 OpenAI Codex 为受支持 Agent，并说明可分别配置 Agent 的模型和推理档位；模型列表由 Netlify 界面提供。

• Agent Runners 支持 Ask 和 Build 两种运行模式：Ask 不改代码也不生成 Deploy Preview；Build 会修改代码并生成 Deploy Preview。

适用边界

• 发布说明没有给出 GPT-6.1 Terra 的专属提示词、推理档位选项或推荐设置；本文不补写这些内容。

• Netlify Function 代码是 API 调用示例，不是模型提示词模板。英文输入只作为发布说明中的演示文本。

• 发布说明未展示安装依赖、函数文件路径或各类函数的独立配置；应按项目当前 Netlify Functions 文档和代码结构处理。

• Agent Runner 的可选模型取决于当前 Netlify 界面和账号配置。模型与推理档位设置是个人偏好，不是共享的项目级或团队级配置。

• 本文整理的是官方配置和工作流说明，不代表已在某个 Netlify 项目或账号中实测。

复现说明

在 Tabbit 浏览器打开 Netlify 发布说明，核对标题、日期、模型 ID、Responses API 代码和函数类型说明；再查看 Netlify AI Gateway 与 Agent Runners 官方文档，核对 Gateway 凭证行为、模型配置入口、运行模式及预览步骤。采集日期为 2026-10-27；Netlify 模型目录和界面之后可能更新。