- 输入 / 输出
- $0.3529 / $1.41
- 上下文
- 29K
- 最大输出
- 4K
- 模态
- 聊天
Hunyuan Role 简介
Hunyuan Role 是腾讯混元为角色扮演调优的对话模型，面向数字分身、角色聊天和陪伴类应用。腾讯用大规模角色对话数据对它做了强化训练，使它能在多轮对话中稳住人设的设定和口吻，更少出戏。它与通用的 Hy3、Hy4 Preview 不同，目标是始终留在角色里，而不是写代码、做分析或跑 agent。
擅长的任务
- 在很长的多轮对话里保持角色的背景、语气和说话习惯，不会滑回中性的助手口吻。
- 腾讯专门用大规模角色对话数据训练它，以减少脱离角色（OOC）的回复。
- 各轮之间上下文连贯，前面的情节和场景细节能延续到后面的对话。
- 为生动、有沉浸感的聊天而调优；腾讯给出的适用场景是数字分身、角色扮演和情感陪聊。
什么情况换别的模型
- 只处理文本：不能读图，依赖互发图片的角色聊天需要换别的模型。
- 不支持工具调用，也不支持按 schema 约束输出，不适合做 agent 后端或数据抽取。
- 上下文和输出上限比当前的通用对话模型小，长篇剧情需要自己维护一份摘要。
快速上手
创建 API 密钥
在 Console 生成一把密钥，平台上的模型都能用。
发送第一个请求
复制你所用语言的示例代码，向该端点发起请求。
文本生成Messages APIPOST/v1/messagesAPI 格式:curl https://api.tokenlab.sh/v1/messages \ -H "Content-Type: application/json" \ -H "x-api-key: sk-xxx" \ -H "anthropic-version: 2023-06-01" \ -d '{ "model": "hunyuan-role", "max_tokens": 1024, "messages": [ {"role": "user", "content": "Hello!"} ] }'
价格
Verified 价格用于 Verified，多数模型更便宜；Official 价格是模型厂商公布的价格，用于更稳定的 Official。Auto 按最终完成请求的线路计价。
价格
每 1M token- Verified 价格
- —
- Official 价格
- 输入$0.3529每 1M token输出$1.41每 1M token
| Official 价格每 1M token | Verified 价格每 1M token | 折扣 | |
|---|---|---|---|
| 输入 | $0.3529 | — | — |
| 输出 | $1.41 | — | — |
用量与动态
成功率是请求完成的比例；延迟是拿到一次完整响应要花的时间，P95 表示 95% 的请求都在这个时间内完成。
用量与可用性
最近 24 小时- 请求
- 成功率
- P95 延迟
- 总 token 数
数据来自汇总的用户请求，不含状态检查。
直接在 Console 里试
Hunyuan Role 已在 Console 备好，提示词已填好，可以直接修改或发送。
帮我用 hunyuan-role 发一条简短消息，接口是 /v1/messages。返回回复，附上延迟和费用。
使用场景
陪伴与角色应用
运行一个有固定背景和说话风格的具名人设用于日常聊天，从第一条消息到第一百条都保持同一种性格。
互动小说
在文字冒险和视觉小说里扮演 NPC 或旁白，每一句回复都要贴合场景和角色的动机。
数字分身
为品牌吉祥物、虚拟主播或创作者的数字分身提供一致的口吻，用来和粉丝对话。
为写作者试写对白
为剧本或游戏试写符合人设的台词，在定稿之前先听听这个角色会怎么回答。
提示词示例
你是林婉，1930 年代上海一家茶馆的老板娘：热心、嘴快，爱引老话。保持角色。一个陌生人冒雨走进来，问你有没有见过他的弟弟。
请扮演奥尔蒂斯船长，一位疲惫、不信任舰载电脑的星舰工程师。我是第一天上岗的新兵。从轮机舱开场，每次回复不超过四句话。
你是小满，我的学习搭子，性格开朗，爱打趣我，但从不放弃我。今晚背单词我想提前收工，用你自己的语气劝我再坚持二十分钟。
费用计算器
FAQ
Hunyuan Role 用来做什么？
用于角色对话。腾讯列出的场景是 AI 数字分身、AI 角色扮演和 AI 情感陪聊。它适合让一个有明确背景和口吻的人设与用户多轮交谈的产品，比如陪伴应用、互动故事和虚拟主播。通用问答、写代码或分析，请改用通用对话模型。
Hunyuan Role 和 Hy3、Hy4 Preview 有什么区别？
Hy3 和 Hy4 Preview 是腾讯面向代码、办公和 agent 任务的通用模型，两者都能调用工具。Hunyuan Role 在角色对话数据上做了进一步训练，目标是稳住人设。它不能调用工具，上下文也小得多，所以人设聊天用它，其他工作用另外两个。
Hunyuan Role 支持图片或工具调用吗？
不支持。它输入文本、输出文本，不接受图片输入，不调用工具，也不返回按 schema 约束的输出。如果角色需要看图或触发某个动作，把这一步交给别的模型，或者整段对话改用多模态对话模型。
长对话里怎样让角色保持一致？
把角色的背景、性格、说话风格和边界写进 system 消息，并在每次请求里都带上。由于上下文有限，把较早的轮次换成一段简短的剧情和关系回顾。模型经过训练能稳住人设，但它只能遵循仍在请求里的内容。
哪些模型和 Hunyuan Role 最接近？
其他为人设调优的对话模型：字节跳动的 Doubao-Seed-Character，以及阿里巴巴的 Qwen Plus Character 和 Qwen Flash Character。它们都面向角色驱动的对话，但来自不同厂商和训练数据，所以选型前请用同一份角色卡在每个模型上跑一遍。
Hunyuan Role 的费用是多少？
在 TokenLab 上，Hunyuan Role 的价格为 输入 $0.3529 / 输出 $1.41 每 1M token。完整明细见上方价格表。
Hunyuan Role 的上下文窗口和输出上限是多少？
Hunyuan Role 最多接收 28,672 token 的上下文，单次最多返回 4,096 token。
Hunyuan Role 应该使用哪个端点？
Hunyuan Role 使用 https://api.tokenlab.sh/v1/messages。代码写法见下方的请求示例。
Hunyuan Role 支持哪些操作？
Hunyuan Role 支持 文本生成。选了操作，上面会显示对应的端点和请求示例。
Hunyuan Role 对比
资料来源
审阅于 2026年10月3日
