应完整记录每次API调用的参数、响应体、耗时及错误信息以排查问题；推荐初学者启用SDK DEBUG日志，生产环境宜手动记录结构化日志并过滤敏感字段，API Explorer可导出人工调用历史。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在批量调用腾讯混元API时完整保留每次请求参数、响应体、耗时及错误信息，用于事后排查超时、格式异常或模型拒答等问题，而不是只看最终返回结果。
启用SDK内置日志（推荐初学者）
腾讯云Python SDK支持全局开启HTTP级别日志，能自动捕获原始请求头、请求体、响应头和响应体。
在初始化客户端前，插入两行日志配置代码：
import logging
logging.basicConfig(level=logging.DEBUG)
这一步操作起来很简单，直接把上面两行加在from tencentcloud.hunyuan.v20230901 import hunyuan_client之前即可。注意不要在生产环境长期开启DEBUG日志，否则会写入大量敏感信息（如SecretKey签名过程）。
SDK会将所有HTTP交互输出到控制台，包含完整的cURL等效命令、JSON请求体和原始响应字符串。
手动记录结构化日志（适合生产环境）
用try/except包裹每次API调用，在成功和异常分支中分别写入结构化日志条目，确保关键字段不丢失。
第一步：定义日志字段映射
log_entry = {
"timestamp": datetime.now().isoformat(),
"model": "hunyuan-pro",
"prompt": user_prompt[:200] + "..." if len(user_prompt) > 200 else user_prompt,
"request_id": response.RequestId if hasattr(response, "RequestId") else "",
"status": "success" if response else "failed"
}
第二步：捕获并记录响应体
在response = client.ChatCompletions(request)之后立即执行：
log_entry["response"] = response.to_json_string() if response else str(e)
第三步：写入本地文件或日志服务
使用jsonlines格式追加写入，避免多线程写入冲突：
with open("hunyuan_calls.jl", "a", encoding="utf-8") as f:
f.write(json.dumps(log_entry, ensure_ascii=False) + "\n")
【必须过滤RequestID和Signature字段】如果日志要归档或上传至第三方系统，需提前从log_entry中删除Authorization、X-TC-Signature等含密字段，否则存在密钥泄露风险。
用API Explorer导出调用历史
方法一：在线调试时勾选“保存为历史记录”
每次在API Explorer中点击“发送请求”，界面右上角会自动保存该次调用的完整输入输出，包括时间戳、请求URL、Headers、Body和Raw Response。
方法二：批量导出全部历史
进入API Explorer → 左侧菜单点“历史记录” → 点击右上角“导出CSV” → 下载包含Method、Path、Status Code、Duration、Request Body、Response Body的表格。
这个导出结果不含认证密钥，可直接用于团队共享分析，但仅限人工触发的调用，无法覆盖程序自动调用场景。
