要让腾讯混元API理解上下文并延续对话逻辑，必须将历史消息按时间顺序、严格使用"role":"user"/"assistant"和字符串content拼成messages数组传入OpenAI兼容接口；原生接口则需用ChatId串轮次，二者不可混用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让腾讯混元API理解上下文并延续对话逻辑，必须把历史消息按严格顺序和角色标识拼成数组传入，漏掉一条或错位就会丢失记忆。
构造符合要求的messages数组
第一步：确认接口使用的是 OpenAI 兼容路径（如 /v1/chat/completions）而非腾讯云原生 SDK 路径。只有兼容接口才接受 messages 字段；原生 SDK 需用 ChatId + 单轮 Prompt 方式串起多轮。
第二步：将全部历史对话整理为 JSON 数组，每条消息含 role 和 content 两个键。role 只能是 【"user" 或 "assistant"】，不能写成 "User"、"USER"、"system" 或留空——任何非标准值会导致 400 错误。
第三步：按时间先后严格排序，最早的一条在最前面，最新提问放在最后。例如三轮对话应为：[{"role":"user","content":"画一只猫"},{"role":"assistant","content":"已生成。"},{"role":"user","content":"给它戴上墨镜"}]。顺序颠倒会触发模型“遗忘”前序内容。
两种典型场景的操作路径
方法一：从零开始新建多轮对话组
直接构造完整 messages 数组 → 调用 POST /v1/chat/completions → 在请求体中填入 {"model":"hunyuan-pro","messages":[...], "temperature":0.7} → 收到响应后保存 assistant 的 content 作为下一轮的输入依据。
方法二：接续已有对话组
先调用混元原生接口 SubmitHunyuanImageChatJob 获取 ChatId → 下次请求时不再拼 messages，而是改用 {"Prompt":"调整背景为星空","ChatId":"1248907282106990592"} → 注意此时不能同时传 messages 字段，否则报错。
注意：OpenAI 兼容接口不识别 ChatId，原生接口不接受 messages。二者不可混用，选错路径会导致参数被忽略或 404。
避免踩坑的关键检查点
检查 messages 中每条 content 是否为字符串类型——若误传 null、数字或对象，接口直接拒绝，错误提示模糊，只显示“invalid message format”。
确保整个 messages 数组长度不超过 32 条。超过后部分历史会被截断，模型无法回溯早期信息。这不是报错，而是静默丢弃，容易误判为“模型失忆”。
不要在 messages 里加入 role="system" 的提示词。混元 OpenAI 兼容接口暂不支持 system 角色，强行添加会导致首条 user 消息被跳过。
