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

# Hy3

> Hy3：騰訊混元 256K 上下文正式版模型，面向程式設計代理、長文件、搜尋問答和複雜任務執行。

Hy3 是騰訊混元面向實際代理工作負載的正式版模型，重點涵蓋程式設計、長文件分析、多輪上下文、搜尋問答和複雜任務執行。

可透過 MixRoute 的 OpenAI 相容 Chat Completions 端點呼叫 `hy3`。

## 核心能力

* 256K 上下文 - 最大輸入 192K token，最大輸出 128K token
* 代理工作流程 - 針對程式設計代理、文件自動化和多步驟執行最佳化
* 推理與工具 - 支援保留式思考、結構化輸出、函式呼叫和快取
* 面向生產 - 相較預覽路由強化任務完成度和工程可用性

## 快速範例

<Tabs>
  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.mixroute.ai/v1/chat/completions" \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "hy3",
        "messages": [
          {
            "role": "user",
            "content": "Review this deployment plan and identify the highest-risk assumption."
          }
        ],
        "max_tokens": 256
      }'
    ```
  </Tab>

  <Tab title="Python">
    ```python theme={null}
    from openai import OpenAI

    client = OpenAI(api_key="YOUR_API_KEY", base_url="https://api.mixroute.ai/v1")

    response = client.chat.completions.create(
        model="hy3",
        messages=[{"role": "user", "content": "Review this deployment plan and identify the highest-risk assumption."}],
        max_tokens=256,
    )

    print(response.choices[0].message.content)
    ```
  </Tab>
</Tabs>

## 參數

| Parameter          | Type    | 必填 | 說明                       |
| ------------------ | ------- | -- | ------------------------ |
| `model`            | string  | 是  | 模型 ID，固定為 `hy3`。         |
| `messages`         | array   | 是  | 包含 role 與 content 的對話訊息。 |
| `max_tokens`       | integer | 否  | 最大生成 token 數。            |
| `stream`           | boolean | 否  | 啟用 SSE 串流輸出。             |
| `reasoning_effort` | string  | 否  | 模型支援時使用的推理強度。            |
| `tools`            | array   | 否  | OpenAI 相容工具定義。           |

## 廠商參考

* [騰訊雲 TokenHub 模型列表](https://cloud.tencent.com/document/product/1823/130051)
