GPT-6.1 Terra：AWS Bedrock 接入配置与工具调用

一句话结论

在 Bedrock 上接入 GPT-6.1 Terra 时，若需服务端工具调用，应选支持该能力的 bedrock-mantle；模型卡的普通请求示例使用 Responses API，但没有展示工具调用对应的 API 请求。

适用场景

• 适合的任务：用 OpenAI Python SDK 通过 Amazon Bedrock 调用 GPT-6.1 Terra，选择端点和模型标识，并判断服务端工具调用是否适用。

• 不适合的任务：仅凭本模型卡配置工具 schema 或复现完整工具调用；页面没有给出工具声明、调用参数或返回示例。

• 适用的模型版本：GPT-6.1 Terra；Bedrock 模型 ID 为 openai.gpt-6.1-terra，bedrock-runtime 跨区域调用另用推理配置文件 ID。

• 适用的客户端、Agent 或 API：OpenAI Python SDK；bedrock-mantle 和 bedrock-runtime 均支持 Responses 与 Chat Completions。模型卡推荐新应用尽可能使用 bedrock-runtime，但该端点不支持此模型的服务端工具调用。

• 推荐的推理档位和参数：未注明。模型卡未列出 Terra 在 Bedrock 上的推理档位或推理参数建议。

可直接使用的内容

先安装官方示例使用的 SDK，并从 Amazon Bedrock 控制台创建长期 API key：

pip install openai

以下是模型卡给出的两个端点配置。请把占位符替换为 Bedrock API key；不要将密钥提交到代码库。

bedrock-mantle：

OPENAI_API_KEY="<Bedrock API key>"
OPENAI_BASE_URL="https://bedrock-mantle.us-east-1.api.aws/openai/v1"

from openai import OpenAI

client = OpenAI()
response = client.responses.create(
    model="openai.gpt-6.1-terra",
    input="Can you explain the features of Amazon Bedrock?"
)
print(response)

bedrock-runtime：

OPENAI_API_KEY="<Bedrock API key>"
OPENAI_BASE_URL="https://bedrock-runtime.us-east-1.amazonaws.com/openai/v1"

from openai import OpenAI

client = OpenAI()
response = client.responses.create(
    model="us.openai.gpt-6.1-terra",
    input="Can you explain the features of Amazon Bedrock?"
)
print(response)

如果使用 bedrock-runtime，页面要求请求使用跨区域推理配置文件 ID，例如 us.openai.gpt-6.1-terra 或 global.openai.gpt-6.1-terra；该模型不提供此端点的区域内推理。IAM 身份除推理配置文件外，还需要对账户默认项目拥有 bedrock:InvokeModel 权限。

测试或工作流步骤

1. 在 Bedrock 控制台生成长期 API key，并安装 openai Python 包。

2. 按目标端点设置 OPENAI_API_KEY 和 OPENAI_BASE_URL。

3. 对 bedrock-mantle，使用 openai.gpt-6.1-terra；对 bedrock-runtime，使用可用的跨区域推理配置文件 ID，并确认 IAM 同时允许访问默认项目。

4. 用 Responses API 发起基础请求并检查响应。

5. 若应用需要服务端工具调用，选择 bedrock-mantle；若选择 bedrock-runtime，不要依赖服务端工具调用。工具 schema 和完整调用流程需依据相应 API 文档另行配置，本页未提供这些细节。

flowchart TD
    A[创建 Bedrock API key 并安装 OpenAI SDK] --> B{选择端点}
    B -->|需要服务端工具调用| C[bedrock-mantle；按工具调用文档配置 API]
    B -->|普通 Responses 调用| D[bedrock-runtime + 跨区域推理 ID]
    C --> E[验证响应]
    D --> F[检查默认项目 IAM 权限]
    F --> E

原始证据与数据

• AWS 模型卡列出两种受支持端点：bedrock-mantle 和 bedrock-runtime。两者均支持 Responses 与 Chat Completions；模型卡还列出 bedrock-runtime 对 Converse、Invoke 的支持，而 bedrock-mantle 不支持这两种 API。

• bedrock-mantle 的模型 ID 为 openai.gpt-6.1-terra，端点格式为 https://bedrock-mantle.{region}.api.aws/openai/v1；页面示例选用 us-east-1。

• bedrock-runtime 的模型 ID 为 openai.gpt-6.1-terra，但调用必须指定跨区域推理配置文件 ID。其基础 URL 格式为 https://bedrock-runtime.{region}.amazonaws.com/openai/v1。

• 模型卡将服务端工具调用列为 bedrock-mantle 支持的能力，将服务端工具使用列为 bedrock-runtime 不支持的能力。

• 模型卡示例使用 OpenAI Python SDK 的 Responses API。页面没有展示工具定义、工具执行器或工具结果的代码。

• bedrock-runtime 的 IAM 身份需要 bedrock:InvokeModel，目标包括推理配置文件及账户默认项目。

适用边界

• 端点可用性、区域支持和推理配置文件可能变化；部署前需按 AWS 当前控制台及账户实际配置核对。

• bedrock-runtime 示例中的 us.openai.gpt-6.1-terra 是跨区域推理配置文件标识，不是区域内模型 ID。页面明确指出该端点不支持此模型的区域内推理。

• 服务端工具调用能力只由模型卡标注为 bedrock-mantle 支持；来源未提供工具 schema、请求示例或调用结果，因此本文不补写可复制的工具调用代码。

• 模型卡推荐新应用尽可能使用 bedrock-runtime；如需服务端工具调用，应优先按其能力表选择 bedrock-mantle，并结合应用需求核对其余端点限制。

• 本文记录官方文档配置，不代表已在特定 AWS 账号、区域或 IAM 策略下实际运行验证。

复现说明

采集时通过 Tabbit 浏览器打开 AWS 官方模型卡及其公开 Markdown 版本，核对端点/API 支持表、Bedrock 功能表、程序化访问表和 Sample Code。提取了两个端点的示例配置和 Responses API 请求；工具调用只记录页面明确给出的端点能力标记。采集日期为 2026-10-27；AWS 文档和区域支持信息之后可能更新。