tencent cloud

混元调用指南

下载
聚焦模式
字号
最后更新时间: 2026-06-12 21:42:22

概述

腾讯混元大模型(Tencent Hy)是由腾讯研发的大语言模型,具备强大的中文创作能力,复杂语境下的逻辑推理能力,以及可靠的任务执行能力。

前提条件

已注册腾讯云账号并开通 TokenHub 服务。
已在 TokenHub 控制台 获取 API Key。

支持的模型

Hy-MT2 是一款面向真实复杂场景的“快思考”多语言翻译模型家族,包含 1.8B、7B、30B-A3B(MoE)三种体量,支持 33 个语种之间的互译,并能高效遵循多语言翻译指令。多维度评测显示,Hy-MT2 在通用翻译、真实业务场景翻译、垂直领域翻译以及指令遵循翻译等任务上均表现出色。
model(调用参数)
能力说明
上下文窗口
最大输入
最大输出
hy-mt2-plus
翻译模型,参数量7B。业界效果领先,开源测试集 Flores200、WMT25 效果领先,专业领域和真实业务场景表现优秀。支持语种齐全,重点支持33个语种互译,支持5种民汉/方言。
8k
4k
4k

基础翻译

最常见的翻译场景,在 user 消息中明确指定目标语种target_lang 使用完整中文名,如“中文”、“英语”)。
"messages": {"role": "user", "content": "将以下文本翻译为 {target_lang},注意只需要输出翻译后的结果,不要额外解释:{source_text}"}
cURL
Python
Java
Node.js
Go
curl -X POST 'https://tokenhub-intl.tencentcloudmaas.com/v1/chat/completions' \\
-H 'Content-Type: application/json' \\
-H 'Authorization: Bearer YOUR_API_KEY' \\
-d '{
"model": "hy-mt2-plus",
"messages": [
{"role": "user", "content": "将以下文本翻译为 英语 ,注意只需要输出翻译后的结果,不要额外解释: 腾讯混元大模型已上线 TokenHub 平台,支持深度思考、结构化输出、Function Calling 等能力。"}
]
}'
from openai import OpenAI

client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://tokenhub-intl.tencentcloudmaas.com/v1",
)

target_lang = "英语"
source_text = "腾讯混元大模型已上线 TokenHub 平台,支持深度思考、结构化输出、Function Calling 等能力。"

prompt = f"""将以下文本翻译为 {target_lang},注意只需要输出翻译后的结果,不要额外解释:
{source_text}"""

response = client.chat.completions.create(
model="hy-mt2-plus",
messages=[{"role": "user", "content": prompt}],
)
print(response.choices[0].message.content)
import okhttp3.*;
import com.google.gson.Gson;
import java.util.*;

public class TranslationDemo {
public static void main(String[] args) throws Exception {
String targetLang = "英语";
String sourceText = "腾讯混元大模型已上线 TokenHub 平台,支持深度思考、结构化输出、Function Calling 等能力。";
String prompt = "将以下文本翻译为 " + targetLang + ",注意只需要输出翻译后的结果,不要额外解释:\\n" + sourceText;

Map<String, Object> body = new HashMap<>();
body.put("model", "hy-mt2-plus");
body.put("messages", List.of(
Map.of("role", "user", "content", prompt)
));

Request request = new Request.Builder()
.url("https://tokenhub-intl.tencentcloudmaas.com/v1/chat/completions")
.header("Authorization", "Bearer YOUR_API_KEY")
.post(RequestBody.create(new Gson().toJson(body),
MediaType.parse("application/json")))
.build();

try (Response response = new OkHttpClient().newCall(request).execute()) {
System.out.println(response.body().string());
}
}
}
import OpenAI from 'openai';

const client = new OpenAI({
apiKey: 'YOUR_API_KEY',
baseURL: 'https://tokenhub-intl.tencentcloudmaas.com/v1',
});

const targetLang = '英语';
const sourceText = '腾讯混元大模型已上线 TokenHub 平台,支持深度思考、结构化输出、Function Calling 等能力。';
const prompt = `将以下文本翻译为 ${targetLang},注意只需要输出翻译后的结果,不要额外解释:\\n${sourceText}`;

const response = await client.chat.completions.create({
model: 'hy-mt2-plus',
messages: [{ role: 'user', content: prompt }],
});
console.log(response.choices[0].message.content);
package main

import (
"bytes"
"encoding/json"
"fmt"
"io"
"net/http"
)

func main() {
targetLang := "英语"
sourceText := "腾讯混元大模型已上线 TokenHub 平台,支持深度思考、结构化输出、Function Calling 等能力。"
prompt := "将以下文本翻译为 " + targetLang + ",注意只需要输出翻译后的结果,不要额外解释:\\n" + sourceText

body, _ := json.Marshal(map[string]interface{}{
"model": "hy-mt2-plus",
"messages": []map[string]string{
{"role": "user", "content": prompt},
},
})

req, _ := http.NewRequest("POST",
"https://tokenhub-intl.tencentcloudmaas.com/v1/chat/completions",
bytes.NewBuffer(body))
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")

resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
data, _ := io.ReadAll(resp.Body)
fmt.Println(string(data))
}
响应示例:
{
"id": "REPLACED_ID",
"object": "chat.completion",
"model": "hy-mt2-plus",
"created": 1775146513,
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "The Tencent Hunyuan large model is now available on the TokenHub platform. It supports capabilities such as deep reasoning, structured output, and Function Calling."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 57,
"completion_tokens": 32,
"total_tokens": 89,
"prompt_tokens_details": {"cached_tokens": 0},
"completion_tokens_details": {"reasoning_tokens": 0}
}
}

结构化数据翻译

当原文是 JSON / Markdown / HTML / XML 等结构化数据时,模型会“锁定结构、仅翻译可见 value、保留所有 key 与占位符”。
"messages": {"role": "user", "content": "
# 任务目标
将下方 {source_text} 中的 {format_type} 格式数据翻译为 {target_lang}

# 严格约束
1. 结构锁定:绝对保持原有的 {format_type} 数据结构、缩进和层级完全不变。
2. 选择性翻译:仅翻译面向用户展示的可见文本内容。
3. 禁止修改:严禁翻译或更改任何代码标签、键名 (Key)、变量占位符(如 {{var}}、${var}、%s、%d 等)或代码属性。

# 数据输入
{source_text}"}
cURL
Python
curl -X POST 'https://tokenhub-intl.tencentcloudmaas.com/v1/chat/completions' \\
-H 'Content-Type: application/json' \\
-H 'Authorization: Bearer YOUR_API_KEY' \\
-d '{
"model": "hy-mt2-plus",
"messages": [
{"role": "user", "content": "# 任务目标\\n将下方 source_text 中的 JSON 格式数据翻译为 英语。\\n\\n# 严格约束\\n1. 结构锁定:绝对保持原有的 JSON 数据结构、缩进和层级完全不变。\\n2. 选择性翻译:仅翻译面向用户展示的可见文本内容。\\n3. 禁止修改:严禁翻译或更改任何代码标签、键名 (Key)、变量占位符(如 {{var}}、${var}、%s、%d 等)或代码属性。\\n\\n# 数据输入\\n{\\"title\\": \\"产品介绍\\", \\"description\\": \\"腾讯混元大模型已上线 TokenHub 平台\\", \\"tags\\": [\\"大模型\\", \\"翻译\\", \\"AI\\"]}"}
]
}'
from openai import OpenAI

client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://tokenhub-intl.tencentcloudmaas.com/v1",
)

target_lang = "英语"
format_type = "JSON"
source_text = '{"title": "产品介绍", "description": "腾讯混元大模型已上线 TokenHub 平台", "tags": ["大模型", "翻译", "AI"]}'

prompt = f"""# 任务目标
将下方 source_text 中的 {format_type} 格式数据翻译为 {target_lang}。

# 严格约束
1. 结构锁定:绝对保持原有的 {format_type} 数据结构、缩进和层级完全不变。
2. 选择性翻译:仅翻译面向用户展示的可见文本内容。
3. 禁止修改:严禁翻译或更改任何代码标签、键名 (Key)、变量占位符(如 {{var}}、${{var}}、%s、%d 等)或代码属性。

# 数据输入
{source_text}"""

response = client.chat.completions.create(
model="hy-mt2-plus",
messages=[{"role": "user", "content": prompt}],
)
print(response.choices[0].message.content)
响应示例:
{
"id": "REPLACED_ID",
"object": "chat.completion",
"model": "hy-mt2-plus",
"created": 1779966611,
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "{\\"title\\": \\"Product Introduction\\", \\"description\\": \\"Tencent Hunyuan Large Model is now available on the TokenHub platform.\\", \\"tags\\": [\\"Large Model\\", \\"Translation\\", \\"AI\\"]}"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 158,
"completion_tokens": 41,
"total_tokens": 199,
"prompt_tokens_details": {"cached_tokens": 0},
"completion_tokens_details": {"reasoning_tokens": 0}
}
}

分隔符翻译

需要逐句对照批量翻译多段文本时,让模型保留等量的分隔符且不遗漏、不转义、不翻译,便于业务侧按下标对齐。
推荐使用 <SEP>### 等不会与目标语言标点冲突的标签作为分隔符。|||--- 等容易被部分语言识别为感叹号、破折号等标点,导致译文不可切分。
"messages": {"role": "user", "content": "请将以下文本准确翻译为 {target_lang}。
你必须在译文中保留等量的分隔符,绝对不可遗漏、转义或翻译该符号,并注意分隔符的位置。{source_text}"}
cURL
Python
curl -X POST 'https://tokenhub-intl.tencentcloudmaas.com/v1/chat/completions' \\
-H 'Content-Type: application/json' \\
-H 'Authorization: Bearer YOUR_API_KEY' \\
-d '{
"model": "hy-mt2-plus",
"messages": [
{"role": "user", "content": "请将以下文本准确翻译为 英语。你必须在译文中保留等量的分隔符,绝对不可遗漏、转义或翻译该符号,并注意分隔符的位置。\\n腾讯混元大模型已上线<SEP>支持深度思考与工具调用<SEP>覆盖 38 种语言互译"}
]
}'
from openai import OpenAI

client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://tokenhub-intl.tencentcloudmaas.com/v1",
)

target_lang = "英语"
SEP = "<SEP>"
source_segments = ["腾讯混元大模型已上线", "支持深度思考与工具调用", "覆盖 38 种语言互译"]
source_text = SEP.join(source_segments)

prompt = f"""请将以下文本准确翻译为 {target_lang}。你必须在译文中保留等量的分隔符,绝对不可遗漏、转义或翻译该符号,并注意分隔符的位置。
{source_text}"""

response = client.chat.completions.create(
model="hy-mt2-plus",
messages=[{"role": "user", "content": prompt}],
)

translated = response.choices[0].message.content.split(SEP)
for src, tgt in zip(source_segments, translated):
print(f"{src.strip()} → {tgt.strip()}")
响应示例:
{
"id": "REPLACED_ID",
"object": "chat.completion",
"model": "hy-mt2-plus",
"created": 1779966612,
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Tencent Hunyuan large model is now live <SEP> Supports deep reasoning and tool invocation <SEP> Covers translation between 38 languages"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 77,
"completion_tokens": 31,
"total_tokens": 108,
"prompt_tokens_details": {"cached_tokens": 0},
"completion_tokens_details": {"reasoning_tokens": 0}
}
}

上下文翻译

当原文存在多义词、专有名词、代词指代等需要语境消歧的情况时,提供“背景信息”可以让模型选用与上下文一致的术语。
"messages": {"role": "user", "content": "
【背景信息】{background_text}
请结合背景信息将以下文本翻译为 {target_lang}。
【待翻译文本】{source_text}"}
cURL
Python
curl -X POST 'https://tokenhub-intl.tencentcloudmaas.com/v1/chat/completions' \\
-H 'Content-Type: application/json' \\
-H 'Authorization: Bearer YOUR_API_KEY' \\
-d '{
"model": "hy-mt2-plus",
"messages": [
{"role": "user", "content": "【背景信息】\\n这是一篇介绍数据库系统的技术文档,上文提到的 transaction 指数据库事务,index 指数据库索引。\\n请结合背景信息将以下文本翻译为 英语。\\n【待翻译文本】\\n事务提交后,索引会被异步刷新到磁盘。"}
]
}'
from openai import OpenAI

client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://tokenhub-intl.tencentcloudmaas.com/v1",
)

target_lang = "英语"
background_text = "这是一篇介绍数据库系统的技术文档,上文提到的 transaction 指数据库事务,index 指数据库索引。"
source_text = "事务提交后,索引会被异步刷新到磁盘。"

prompt = f"""【背景信息】
{background_text}
请结合背景信息将以下文本翻译为 {target_lang}。
【待翻译文本】
{source_text}"""

response = client.chat.completions.create(
model="hy-mt2-plus",
messages=[{"role": "user", "content": prompt}],
)
print(response.choices[0].message.content)
响应示例:
{
"id": "REPLACED_ID",
"object": "chat.completion",
"model": "hy-mt2-plus",
"created": 1779966614,
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "After a transaction is committed, the index is asynchronously flushed to disk."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 68,
"completion_tokens": 15,
"total_tokens": 83,
"prompt_tokens_details": {"cached_tokens": 0},
"completion_tokens_details": {"reasoning_tokens": 0}
}
}

术语表翻译

业务侧拥有领域术语表(产品名、品牌词、专有名词等需固定译法)时,将术语对照清单作为参考前置,模型会优先按指定译法翻译。
"messages": {"role": "user", "content": "
参考下面的翻译:
{text} 翻译成 {text}
{text} 翻译成 {text}
{text} 翻译成 {text}
将以下文本翻译为 {target_lang},注意只需要输出翻译后的结果,不要额外解释:{source_text}"}
cURL
Python
curl -X POST 'https://tokenhub-intl.tencentcloudmaas.com/v1/chat/completions' \\
-H 'Content-Type: application/json' \\
-H 'Authorization: Bearer YOUR_API_KEY' \\
-d '{
"model": "hy-mt2-plus",
"messages": [
{"role": "user", "content": "参考下面的翻译:\\n混元大模型 翻译成 Tencent Hy\\n腾讯云 翻译成 Tencent Cloud\\n深度思考 翻译成 deep reasoning\\n将以下文本翻译为 英语,注意只需要输出翻译后的结果,不要额外解释:\\n腾讯云上的混元大模型支持深度思考能力。"}
]
}'
from openai import OpenAI

client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://tokenhub-intl.tencentcloudmaas.com/v1",
)

target_lang = "英语"
glossary = [
("混元大模型", "Tencent Hy"),
("腾讯云", "Tencent Cloud"),
("深度思考", "deep reasoning"),
]
source_text = "腾讯云上的混元大模型支持深度思考能力。"

glossary_text = "\\n".join(f"{src} 翻译成 {tgt}" for src, tgt in glossary)
prompt = f"""参考下面的翻译:
{glossary_text}
将以下文本翻译为 {target_lang},注意只需要输出翻译后的结果,不要额外解释:
{source_text}"""

response = client.chat.completions.create(
model="hy-mt2-plus",
messages=[{"role": "user", "content": prompt}],
)
print(response.choices[0].message.content)
响应示例:
{
"id": "REPLACED_ID",
"object": "chat.completion",
"model": "hy-mt2-plus",
"created": 1779967706,
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Tencent Hy on Tencent Cloud supports deep reasoning capabilities."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 72,
"completion_tokens": 13,
"total_tokens": 85,
"prompt_tokens_details": {"cached_tokens": 0},
"completion_tokens_details": {"reasoning_tokens": 0}
}
}

风格翻译

不同业务场景对译文风格要求不同(口语化 / 书面化 / 营销文案 / 法律合同 / 学术 / 古文等),描述出目标风格,模型会按要求调整用词与句式。
"messages": {"role": "user", "content": "
请将以下文本翻译为 {target_lang}。
注意翻译的风格要严格符合【{target_style}】
{source_text}"}
cURL
Python
curl -X POST 'https://tokenhub-intl.tencentcloudmaas.com/v1/chat/completions' \\
-H 'Content-Type: application/json' \\
-H 'Authorization: Bearer YOUR_API_KEY' \\
-d '{
"model": "hy-mt2-plus",
"messages": [
{"role": "user", "content": "请将以下文本翻译为 英语。注意翻译的风格要严格符合【营销文案:语言简洁有力、富有感染力、突出卖点,适合面向海外开发者的产品介绍】\\n腾讯混元大模型,开箱即用,让 AI 应用开发更简单。"}
]
}'
from openai import OpenAI

client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://tokenhub-intl.tencentcloudmaas.com/v1",
)

target_lang = "英语"
target_style = "营销文案:语言简洁有力、富有感染力、突出卖点,适合面向海外开发者的产品介绍"
source_text = "腾讯混元大模型,开箱即用,让 AI 应用开发更简单。"

prompt = f"""请将以下文本翻译为 {target_lang}。注意翻译的风格要严格符合【{target_style}】
{source_text}"""

response = client.chat.completions.create(
model="hy-mt2-plus",
messages=[{"role": "user", "content": prompt}],
)
print(response.choices[0].message.content)
响应示例:
{
"id": "REPLACED_ID",
"object": "chat.completion",
"model": "hy-mt2-plus",
"created": 1779966617,
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Tencent Hunyuan Large Model is ready to use right out of the box, making AI application development easier than ever."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 66,
"completion_tokens": 25,
"total_tokens": 91,
"prompt_tokens_details": {"cached_tokens": 0},
"completion_tokens_details": {"reasoning_tokens": 0}
}
}

支持的语言

语言
英文名
代码
简体中文
Chinese
zh
繁体中文
Traditional Chinese
zh-Hant
英语
English
en
法语
French
fr
葡萄牙语
Portuguese
pt
西班牙语
Spanish
es
日语
Japanese
ja
土耳其语
Turkish
tr
俄语
Russian
ru
阿拉伯语
Arabic
ar
韩语
Korean
ko
泰语
Thai
th
意大利语
Italian
it
德语
German
de
越南语
Vietnamese
vi
马来语
Malay
ms
印尼语
Indonesian
id
菲律宾语
Filipino
tl
印地语
Hindi
hi
波兰语
Polish
pl
捷克语
Czech
cs
荷兰语
Dutch
nl
高棉语
Khmer
km
缅甸语
Burmese
my
波斯语
Persian
fa
古吉拉特语
Gujarati
gu
乌尔都语
Urdu
ur
泰卢固语
Telugu
te
马拉地语
Marathi
mr
希伯来语
Hebrew
he
孟加拉语
Bengali
bn
泰米尔语
Tamil
ta
乌克兰语
Ukrainian
uk
藏语
Tibetan
bo
哈萨克语
Kazakh
kk
蒙古语
Mongolian
mn
维吾尔语
Uyghur
ug
粤语
Cantonese
yue


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈