> ## 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-Hant/api-reference/endpoint/chat-openai.md) · [Responses 介面說明](https://mixroute.ai/docs/zh-Hant/api-reference/endpoint/responses-openai.md)


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