腾讯混元API返回空content的五大原因：①FinishReason为stop（prompt设计不当）、②length（max_tokens过小）、③content_filter（安全拦截或输入超长/含非法字符）、④SDK版本不匹配导致取错Messages字段、⑤OpenAI兼容接口model参数拼写错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
腾讯混元API返回空的content，意味着请求成功（HTTP 200）、响应结构完整，但Choices[0].Messages[0].Content字段为空字符串或null，导致你拿不到任何模型输出。这不是网络失败，而是模型在推理链路中提前终止或内容被截断。
检查FinishReason是否为stop/length/content_filter
解析响应JSON，定位到Response.Choices[0].FinishReason字段：
若值为【stop】：说明模型正常生成完毕，content为空大概率是prompt设计问题，比如系统提示词写了“仅输出JSON不带解释”，而实际输出不符合格式要求，模型选择沉默；
若值为【length】：表示max_tokens设得太小，模型还没开始生成正文就被强制截断，此时content为空或只有开头几个字；
若值为【content_filter】：内容触发安全策略被主动拦截，不会报错也不会返回文本，只留空content——这是最常被忽略的真凶。
验证输入prompt是否含非法字符或超长空白
方法一：用Python原生strip()和repr()检查
print(repr(prompt)) → 观察是否出现\u200b（零宽空格）、\uFEFF（BOM头）、连续换行符\n\n\n等不可见字符；
方法二：长度硬校验
len(prompt.encode('utf-8')) > 128000时，腾讯混元API会静默丢弃整个输入，不报错也不返回content，只返回FinishReason: "content_filter"。
确认是否误用了非流式接口却未处理嵌套结构
第一步：打开响应原始JSON，搜索"Content"关键词；
第二步：如果找到的是Response.Choices[0].Message.Content（注意是Message不是Messages），说明你调用的是老版v20230901 SDK，但服务端已升级响应格式，新版本统一为Messages数组；
第三步：用SDK v20241201或更高版本重试，或手动取Response.Choices[0].Messages[0].Content；
旧SDK会把新格式的Messages数组当成单个Message对象解析，导致取到None。
排查TokenHub兼容接口的model参数拼写错误
使用OpenAI兼容接口（base_url=https://api.cloudai.tencent.com/v1）时，model字段必须严格匹配官方命名：
✅ 正确写法："hy3-295b"、"hunyuan-pro"、"HY-Image-V3.0"；
❌ 错误写法："hy3"、"hunyuan_pro"、"hy3-295B"（大小写敏感）、"hy3-295b-v1"（后缀不存在）；
model参数错误会导致服务端跳过模型加载，直接返回空content+FinishReason: "stop"，且不报4xx错误。
