混元 Hy3 的 API 应如何接入？

1. 接入前提与端点

接入腾讯云 TokenHub 调用 Hy3，需先注册腾讯云账号并开通 TokenHub 服务，随后在控制台的 API Key 管理页面创建密钥并妥善保存。境内接入地址为 https://tokenhub.tencentmaas.com/v1，境外地址为 https://tokenhub-intl.tencentmaas.com/v1，平台另提供 .cn 域名作为默认地址不可用时的备用接入点。鉴权统一采用 Authorization: Bearer YOUR_API_KEY 请求头。

2. 协议兼容性与调用形态

TokenHub 兼容 OpenAI Chat Completions API、OpenAI Responses 与 Anthropic Messages API 三类协议，开发者可直接使用 OpenAI 官方 SDK，把 base_url 指向 TokenHub 地址并将 model 设为 hy3，原有调用代码无需改动。Python 与 Node.js 可直接使用官方 SDK，Java 与 Go 使用标准 HTTP 客户端请求 OpenAI 兼容接口。调用形态覆盖单轮对话、流式输出与工具调用三类，流式请求需将 stream_options.include_usage 设为 true 以在末尾分片获取完整用量统计。

3. 深度思考参数传递

在 Python SDK 中，thinking 与 reasoning_effort 属于非标准字段，需通过 extra_body 透传，思考过程需通过 getattr(msg, "reasoning_content") 读取；Node.js 中这两个字段可直接展开至请求体顶层。