必须使用腾讯云官方sdk并严格匹配签名机制：获取带hunyuan权限的密钥对、用指定服务地址、通过defaultprofile初始化客户端、构造合规chatcompletionsrequest（role限system/user/assistant）、流式响应需手动处理sse并关闭连接。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Java后端稳定调用腾讯混元大模型API，必须绕过浏览器限制、规避鉴权失效风险，并确保请求体结构与腾讯云签名机制严格匹配。
获取合法API密钥与服务地址
登录腾讯云控制台 → 进入【Hunyuan大模型】服务页 → 点击左侧【API密钥管理】→ 创建新的密钥对（SecretId + SecretKey），【务必勾选“Hunyuan API”权限】，否则后续所有请求均返回403错误。
在【服务概览】页复制「服务接入地址」，格式为 https://hunyuan.tencentcloudapi.com，注意末尾无斜杠；该地址不可替换为OpenRouter或其他中转地址，腾讯云强制校验Host头与证书域名一致性。
引入官方SDK并配置认证
在pom.xml中添加腾讯云Hunyuan SDK依赖（截至2026年9月最新版）：
初始化客户端时，必须使用 【腾讯云凭证Provider链】而非硬编码密钥】：新建DefaultProfile对象传入Region（如ap-guangzhou）、SecretId、SecretKey；若部署在CVM上，可直接使用CvmRoleCredentialProvider自动拉取实例角色密钥，避免密钥泄露风险。
构造合规的请求对象
第一步：创建HunyuanClient实例，传入profile和clientProfile（需显式设置HttpProfile超时为30秒以上，因长文本生成可能耗时达25秒）。
第二步：构建ChatCompletionsRequest对象，设置model为“hunyuan-pro”或“hunyuan-turbo”，messages字段必须是List
第三步：调用client.ChatCompletions(request)发起同步调用；异步方式需自行封装CompletableFuture，SDK原生不支持Callback回调。
处理响应与流式输出
方法一：接收完整响应
直接获取ChatCompletionsResponse对象，从choices.get(0).getMessage().getContent()提取文本结果；注意检查response.getUsage()中的totalTokens，超限将触发429错误且不计费。
方法二：启用流式响应（仅限hunyuan-turbo模型）
在request中设置stream = true，然后用client.getHttpClient().execute()手动发送HttpPost，解析SSE格式响应流；每行以data:开头，需逐行读取、跳过空行、JSON.parse()解码，【首次收到的data: [DONE]表示流结束，必须主动关闭连接】，否则连接持续占用导致后续请求阻塞。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
