调用 Hy4 正式版时,请求中的模型 ID 使用 hy4;hy4-preview 是单独的预览版 ID。TokenHub 文档还给出 Hy4 的深度思考、推理深度、图片输入及工具调用字段。
适合的任务:在腾讯云 TokenHub 上调用 Hy4 正式版,设置推理深度,或提交文本与图片输入。
不适合的任务:把 hy4-preview 当成正式版 ID;将本文当作完整的密钥开通或 SDK 初始化教程。
适用的模型版本:Hy4 正式版,调用值为 hy4。
适用的客户端、Agent 或 API:TokenHub OpenAI Chat Completions;文档另称 hy4 兼容 OpenAI Responses 和 Anthropic Messages API。
推荐的推理档位和参数:文档称 Hy4 默认开启深度思考,默认推理深度为 high;请求示例使用 thinking: {"type":"enabled"} 和 reasoning_effort: "high"。
以下示例按 TokenHub 文档的 Chat Completions 请求格式组合,展示正式版 ID、推理参数和图片内容块。把 YOUR_API_KEY、YOUR_IMAGE_URL 替换为自己的值。
curl -X POST 'https://tokenhub.tencentmaas.com/v1/chat/completions' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"model": "hy4",
"messages": [{"role": "user", "content": [
{"type": "text", "text": "请描述图片中的主要内容。"},
{"type": "image_url", "image_url": {"url": "YOUR_IMAGE_URL"}}
]}],
"thinking": {"type": "enabled"},
"reasoning_effort": "high",
"stream": false
}'正式版:model: "hy4"。
预览版:model: "hy4-preview",不要与正式版混用。
文档列出的 Hy4 上下文窗口为 1024k,最大输入 960k,最大输出 64k。
图片输入使用 messages[].content 内容块:type: "image_url",图片地址放在 image_url.url;同一数组可放文本块。
流式请求可设置 stream: true;如需最后一个数据块包含 usage,追加 stream_options: {"include_usage": true}。
在请求中将 model 明确设为 hy4,并确认没有沿用 hy4-preview。
需要显式控制思考时,按文档请求示例传入 thinking: {"type":"enabled"};推理深度示例使用 reasoning_effort: "high"。文档同时说明 Hy4 默认开启深度思考且默认深度为 high。
需要图片理解时,在用户消息的 content 数组中加入 image_url 内容块和文字任务说明。
使用工具调用时,按普通 Chat Completions tools / tool_choice 结构发送;若后续轮次需要延续文档示例中的思考上下文,应将 assistant 的 reasoning_content 与工具结果一并回填。
检查响应中的 model、tool_calls、finish_reason 和 usage,确认服务返回的是预期模型及结束状态。
TokenHub 的模型表将 hy4 明确称为“Hy4 正式版”,并称其增强 Agent、长程和真实生产力任务能力,首次引入视觉理解;表中与 hy4-preview 分列。
文档写明 hy4 兼容 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages;其中的请求示例统一使用 https://tokenhub.tencentmaas.com/v1/chat/completions。
基础对话、深度思考、推理深度、工具调用和图片理解示例的 model 均为 hy4。深度思考示例展示 thinking: {"type":"enabled"};推理配置示例展示 reasoning_effort: "high"。
图片理解示例通过 content 数组传入 {"type":"image_url","image_url":{"url":"YOUR_IMAGE_URL"}},并可同时传入 {"type":"text","text":"..."}。
文档说明流式调用以 SSE 增量返回;stream_options.include_usage 可用于在最后一个 chunk 获取完整 usage。
本文记录 TokenHub 文档中的模型 ID 和请求字段;具体协议字段支持情况以所选 API 协议和当前 TokenHub 文档为准。
文档中的图片示例展示 URL 输入;没有据此推断图片大小、格式、可访问性或 Base64 的额外限制。
reasoning_content 是文档响应示例与工具续接示例中的字段。业务侧应按自身数据处理规范决定是否保存或展示。
腾讯云开发者社区的 Hy4 接入说明 列出了另一个 base_url。配置时请按实际接入渠道及其官方文档核对地址。
于 2026-11-16 通过 Tabbit 打开腾讯云 TokenHub《混元调用指南》,核对模型表、基础对话、深度思考、推理深度、流式请求、工具调用和图片理解章节。页面显示最近更新时间为 2026-11-16 12:15:31。文档页面可读;登录相关的非文档请求返回 401,不影响公开正文核对。
Hy4