腾讯混元API返回结构差异源于接口类型（原生SDK/ OpenAI/ Anthropic兼容）、版本及stream参数不同：原生SDK响应含Response.Choices，OpenAI兼容含choices，Anthropic兼容含content；流式响应需逐段解析delta.content并拼接，且不可直接按非流式字段访问。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
腾讯混元API返回的JSON结构与你手头文档里的示例字段不一致，比如找不到Response.Choices[0].Messages，或usage字段位置变了，甚至整个顶层键名都不同——这说明你调用的接口版本、模型类型或请求参数（如Stream开关）与示例所依赖的上下文不匹配。
确认你调用的是哪个接口和版本
腾讯混元当前存在三套并行接口规范：原生SDK接口、OpenAI兼容接口、Anthropic兼容接口。它们返回结构完全不同。
第一步：检查你代码中初始化客户端的方式——如果用了tencentcloud.hunyuan.v20230901包，那就是原生SDK接口；如果用了anthropic或openai官方SDK，并把base_url设为https://api.hunyuan.cloud.tencent.com/v1，那就是对应兼容接口。
第二步：打开你实际发起请求的URL，对照官方文档确认路径：
原生SDK走https://hunyuan.tencentcloudapi.com/；
OpenAI兼容走https://api.hunyuan.cloud.tencent.com/v1/chat/completions；
Anthropic兼容走https://api.hunyuan.cloud.tencent.com/anthropic/v1/messages。
【不同接口的响应结构不可互换参考】，拿OpenAI兼容接口的示例去解析原生SDK返回，必然字段缺失。
区分流式与非流式响应结构
非流式响应（Stream=False）返回一个完整JSON对象，原生SDK中关键内容在Response.Choices[0].Message.Content，而OpenAI兼容接口中则在choices[0].message.content。
流式响应（Stream=True）返回多个SSE事件，每个事件是一个独立JSON片段，没有Choices或choices数组，只有delta.content或Delta.Content字段，必须拼接才能得到完整文本。
如果你按非流式逻辑直接取resp.Choices，但实际请求发的是Stream=True，Python SDK会抛出AttributeError——因为流式响应返回的是生成器，不是带Choices属性的对象。
查看真实响应体再写解析逻辑
方法一：用print(resp.to_json_string())（原生SDK）或print(resp.json())（requests调用）打印原始响应，不要跳过这步。
方法二：在腾讯云控制台「调用记录」里找到对应请求，点开查看完整返回体——这里看到的才是你代码真正收到的东西。
方法三：用curl手动发一次最小化请求，绕过SDK验证基础结构：curl -X POST "https://api.hunyuan.cloud.tencent.com/v1/chat/completions" -H "Authorization: Bearer YOUR_KEY" -H "Content-Type: application/json" -d '{"model":"hunyuan-lite","messages":[{"role":"user","content":"test"}]}'
拿到真实响应后，再决定用resp["choices"][0]["message"]["content"]还是resp["Response"]["Choices"][0]["Messages"][0]["Content"]，而不是凭印象硬套。
处理字段缺失的容错写法
第一步：始终先检查顶层键是否存在。
原生SDK响应一定有"Response"键；OpenAI兼容响应一定有"choices"键；Anthropic兼容响应一定有"content"键。
第二步：用.get()链式取值，避免KeyError：content = resp.get("Response", {}).get("Choices", [{}])[0].get("Messages", [{}])[0].get("Content", "")
第三步：对流式响应单独处理，判断isinstance(resp, types.GeneratorType)或捕获TypeError来识别是否为流式返回。
第四步：在日志里记录每次响应的type(resp)和dir(resp)，尤其当resp是SDK自定义对象时，它的属性访问方式和字典不同——比如原生SDK的resp.Usage.TotalTokens不能写成resp["Usage"]["TotalTokens"]。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
