需先获取腾讯云secretid、secretkey及模型名（如hunyuan-pro）并存入环境变量；安装tencentcloud-sdk-python，用credential和hunyuanclient初始化；fastapi中封装/v1/chat/completions路由，转换openai格式请求，处理system角色合并与流式响应（依赖isend字段判断结束）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
准备腾讯混元API密钥与模型信息
要在FastAPI服务中调用腾讯混元大模型，必须先获取合法的访问凭证和目标模型标识，否则所有请求都会被腾讯云网关拒绝返回401错误。
登录腾讯云控制台→进入【大模型服务】→点击【API密钥管理】→创建新密钥，得到 【SecretId 和 SecretKey】；同时在【模型广场】确认你要调用的具体模型名称，例如 hunyuan-pro 或 hunyuan-lite（注意大小写与连字符）。
把 SecretId、SecretKey 和 model_name 三项存进环境变量，不要硬编码进Python文件——否则Git提交后密钥泄露无法撤回。
安装适配依赖并初始化客户端
执行 pip install tencentcloud-sdk-python 快速安装官方SDK；该包已内置HMAC-SHA256签名逻辑，无需手动拼接Authorization头。
新建 hunyuan_client.py，导入模块并实例化：from tencentcloud.common import credential；from tencentcloud.hunyuan.v20230901 import hunyuan_client, models；cred = credential.Credential(SECRET_ID, SECRET_KEY)；client = hunyuan_client.HunyuanClient(cred, "ap-guangzhou") ——地域必须填实际部署区域，填错会报 InvalidRegion 错误。
在FastAPI中封装同步调用接口
定义一个 POST /v1/chat/completions 路由，接收标准OpenAI格式的JSON请求体（含 messages、model、temperature 等字段）。
将 messages 列表转为字符串拼接（role: content 换行格式），构造 hunyuan_client.models.DescribeChatProRequest() 实例，设置 Prompt、Model、Temperature 字段；注意腾讯混元不接受 system 角色，需把 system 内容合并进第一个 user message 开头。
调用 client.DescribeChatPro(request) 获取响应，再把 Result.Text 提取出来，包装成 OpenAI 兼容的 choices[0].message.content 格式返回。
处理流式响应（SSE）
方法一：使用腾讯云 hunyuan-chatpro 接口的 Stream=True 参数（仅部分模型支持，如 hunyuan-standard）。
方法二：若目标模型不支持原生流式，就用 FastAPI 的 StreamingResponse + 后台线程模拟流式：启动一个线程调用 DescribeChatPro，每收到一个 token 就 yield f"data: {json.dumps({'delta': {'content': token}})}\n\n"；注意必须设置 headers={"Content-Type": "text/event-stream"}。
【关键限制】腾讯混元当前所有流式接口均不返回 finish_reason，需靠 response 中的 IsEnd 字段判断终止，否则前端会一直等待。
启动FastAPI服务并验证
运行 uvicorn main:app --host 0.0.0.0 --port 8000 --reload。
用 curl -X POST http://localhost:8000/v1/chat/completions -H "Content-Type: application/json" -d '{"messages":[{"role":"user","content":"你好"}],"model":"hunyuan-pro"}' 测试基础通路。
若返回 {"choices":[{"message":{"content":"你好！我是混元大模型。"}}]}，说明接入成功。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
