需先开通腾讯云混元服务并创建api密钥，secretkey仅显示一次且须下载csv保存；.net调用需配置正确endpoint、region及http头，openai兼容接口须用tokenhub api key而非cam密钥。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
开通混元服务并获取API密钥
你需要先在腾讯云开通混元大模型服务，否则后续所有.NET调用都会返回403权限错误。访问 腾讯混元控制台 → 点击“立即开通” → 勾选协议并提交。开通成功后，左侧菜单进入“API密钥管理” → 点击“创建API密钥”。【SecretKey仅在创建时完整显示一次，关闭页面后无法再次查看】。务必点击右上角“下载CSV”保存全部信息——SecretKey是32位大小写字母+数字组合，开头不是sk-，别和OpenAI密钥混淆。
配置.NET后端请求（SDK方式）
新建一个名为 TencentHunyuanClient.cs 的类文件，通过NuGet安装官方SDK：TencentCloud.Hunyuan（注意不是TencentCloud.Sms或TencentCloud.Common）。在Visual Studio中右键项目→“管理NuGet包”→搜索并安装该包。
在类中声明两个私有字段：private readonly string _secretId = "你的SecretId"; 和 private readonly string _secretKey = "你的SecretKey";，值填入CSV中对应内容。构造 ClientProfile 时必须指定 Endpoint 为 hunyuan.tencentcloudapi.com，Region 必须填 ap-guangzhou（广州地域），其他地域会返回InvalidRegion错误。
调用 ChatPro 接口前，必须设置 HttpProfile.ReqMethod = "POST"，且 ContentType = "application/json; charset=utf-8"，否则返回400 Bad Request。这一步漏掉会导致调试半天找不到原因。
使用OpenAI兼容接口接入（推荐轻量项目）
方法一：直接HTTP请求（无需SDK）
在.NET项目中新建一个 HunyuanOpenAIClient.cs 类，使用 HttpClient 发起POST请求到 https://api.hunyuan.cloud.tencent.com/v1/chat/completions。请求头必须包含：Authorization: Bearer {your_api_key}，Content-Type: application/json。注意：这里的 your_api_key 是你在TokenHub控制台创建的API Key，不是CAM密钥——【混元OpenAI兼容接口只认TokenHub API Key，填错CAM密钥会返回401 Unauthorized】。
方法二：复用OpenAI SDK（最快上手）
安装 OpenAI.SDK NuGet包，然后初始化客户端：var client = new OpenAIClient("你的TokenHub_API_Key", new HttpClient() { BaseAddress = new Uri("https://api.hunyuan.cloud.tencent.com/v1/") });
调用时指定模型名如 hunyuan-pro 或 hunyuan-turbo，消息格式与OpenAI完全一致，无需改造现有逻辑。
测试调用与响应解析
第一步：在控制器中注入你封装好的客户端（如 IHunyuanService）；
第二步：构造标准消息数组：new[] { new ChatMessage(ChatRole.User, "你好，请用中文简单介绍你自己") }；
第三步：调用 client.ChatCompletionAsync(messages, model: "hunyuan-turbo")；
第四步：检查响应对象的 Choices[0].Message.Content 字段是否非空且含中文文本；
第五步：若返回 "error": {"code":"Unauthorized","message":"invalid api key"}，立即核对是否误用了CAM密钥而非TokenHub API Key。
