> ## Documentation Index
> Fetch the complete documentation index at: https://mixroute.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# GPT 6.1 Terra

> 快速、高效的 OpenAI 模型，适用于视觉推理、屏幕操作工作流和清晰写作，支持文字与图片输入。

GPT 6.1 Terra 适用于商品图片和技术图纸理解、文本起草及范围明确的编程任务。它与 GPT 5.6 Terra、GPT 6.1 Sol 是不同模型。

## 模型信息

| 字段 | 说明 |
| - | - |
| Model ID | `gpt-6.1-terra` |
| 上下文窗口 | 1,050,000 tokens |
| 最大输出 | 128,000 tokens |
| 输入 | 文字和图片，不原生支持音频或视频输入。 |
| 输出 | 文本；可通过兼容接口使用结构化输出。 |

> [!NOTE]
>
> 上述长度为厂商规格。实际限制、可用性、价格、Responses 接入和托管工具支持取决于 MixRoute 路由；模型可用不代表所有上游工具均已开放。

## 推理与工具调用

支持 `none`、`low`、`medium`（默认）、`high`、`xhigh`、`max`。`none` 关闭推理；本模型不支持 `minimal`。

Chat Completions 使用顶层 `reasoning_effort`；Responses 使用嵌套的 `reasoning.effort`。

> [!WARNING]
>
> 工具调用必须使用 Responses，即使推理强度为 `none` 也一样。不要在此模型的 Chat Completions 请求中传入 `tools` 或 `tool_choice`；工具工作流需选择支持 Responses 的路由。

推理强度不为 `none` 时，省略 `temperature`、`top_p`、`top_logprobs`，同时省略 Chat Completions 的 `logprobs` 和 Responses 的 `include: ["message.output_text.logprobs"]`。

## Chat Completions 示例

将 `MIXROUTE_API_KEY` 设为你的 MixRoute API Key。示例使用 `low` 推理强度，不附带工具。

**cURL**

```bash theme={null}
curl "https://api.mixroute.ai/v1/chat/completions" \
  -H "Authorization: Bearer $MIXROUTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-terra",
    "messages": [{"role": "user", "content": "Draft a concise status update for a software project."}],
    "reasoning_effort": "low",
    "max_completion_tokens": 2048
  }'
```

**Python**

```python theme={null}
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["MIXROUTE_API_KEY"],
    base_url="https://api.mixroute.ai/v1",
)
response = client.chat.completions.create(
    model="gpt-6.1-terra",
    messages=[{"role": "user", "content": "Draft a concise status update for a software project."}],
    reasoning_effort="low",
    max_completion_tokens=2048,
)
print(response.choices[0].message.content)
```

## 请求字段

| 参数 | 必填 | 说明 |
| - | - | - |
| `model` | 是 | 使用 `gpt-6.1-terra`。 |
| `messages` | 是 | 包含 `role` 和 `content` 的会话消息。 |
| `reasoning_effort` | 否 | none / low / medium / high / xhigh / max，默认 medium。 |
| `max_completion_tokens` | 否 | 包含推理 token 和可见输出 token 的预算，同时受模型与路由限制。 |
| `stream` | 否 | 设为 true 开启 SSE 流式响应；文本增量位于 `choices[0].delta.content`。 |

## Responses 接入

在支持 Responses 的 MixRoute 路由上，使用 `input`、`reasoning.effort` 和 `max_output_tokens` 替代 Chat Completions 对应字段：

```bash theme={null}
curl "https://api.mixroute.ai/v1/responses" \
  -H "Authorization: Bearer $MIXROUTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-terra",
    "input": "Draft a concise status update for a software project.",
    "reasoning": {"effort": "low"},
    "max_output_tokens": 2048,
    "store": false
  }'
```

Responses 函数工具的 `name`、`description`、`parameters` 位于工具对象顶层，不嵌套在 `function` 中。应用执行模型返回的调用，并以相同 `call_id` 回传 `function_call_output`。

后续轮次需保留必要的完整输出项，包括推理项。托管计算机操作等工具需要额外的路由支持和应用集成，不会因更换模型 ID 自动启用。

[Chat Completions 接口说明](https://mixroute.ai/docs/zh-Hans/api-reference/endpoint/chat-openai.md) · [Responses 接口说明](https://mixroute.ai/docs/zh-Hans/api-reference/endpoint/responses-openai.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.