必须显式传入temperature参数，范围0.0～2.0，省略将返回400错误；推荐角色扮演用0.35、创意文案用0.85；各平台设置需严格遵循格式要求。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在调用腾讯混元API时精准控制输出的随机性与稳定性，必须在请求体中显式传入temperature参数，不能依赖默认值或服务端配置——混元各模型（如hunyuan-pro、hy3、hy4-preview）均不提供全局temperature预设，每次请求都需携带该参数。
在OpenAI兼容接口中设置temperature
混元的OpenAI兼容接口（https://api.hunyuan.cloud.tencent.com/v1/chat/completions）要求temperature作为JSON payload字段直接传入：
第一步：确保请求头含 Authorization: Bearer YOUR_SECRET_KEY，且Content-Type为application/json；
第二步：在POST body的JSON中，必须包含"temperature": 0.35字段，数值范围严格限定在0.0～2.0之间；
第三步：若省略该字段，API将返回HTTP 400错误并提示“missing required parameter: temperature”，【不会回退到默认值】；
第四步：温度值低于0.3时，模型输出趋于机械复述，易出现重复句式或拒绝生成新内容；高于0.7后，逻辑连贯性明显下降，可能编造事实或脱离人设——角色扮演类任务推荐固定使用0.35，创意文案可试0.85。
通过Python SDK设置temperature
使用腾讯云官方Python SDK（tencentcloud-sdk-python-hunyuan）时，temperature需绑定在请求对象上：
方法一：直接赋值给ChatCompletionsRequest实例的Temperature属性：
req = models.ChatCompletionsRequest()
req.Temperature = 0.35
方法二：若使用字典构造messages，temperature必须与model、messages同级传入，不可嵌套在messages内部；
注意：【SDK版本v3.0.1120+才支持Temperature字段直传，旧版需手动拼接JSON并调用RawHttpRequest】。
在第三方平台中调整temperature
CherryStudio、OpenWebUI等前端工具对temperature的支持方式不同：
CherryStudio：进入「设置→模型服务→腾讯混元→高级参数」，找到Temperature滑块，拖动后需点击「保存配置」才生效，重启客户端不保留未保存值；
OpenWebUI：在「设置→外部链接→腾讯混元→模型参数」中填入{"temperature": 0.35}，格式必须为合法JSON对象，多一个逗号或引号都会导致模型切换失败；
扣子（Coze）工作流：在大模型节点参数区直接输入数字0.35，无需引号，输入框旁有实时校验——若显示红色报错，说明输入了字母、空格或超出0.0–2.0范围的值。
