必须通过HTTP POST调用腾讯混元文生图API批量制图，需先在腾讯云控制台获取SecretId/SecretKey，使用指定接入点https://hunyuan.tencentcloudapi.com，按规范构造含签名的请求头与JSON体（含Model、Prompt、Size、N），成功后凭TaskId轮询结果，Status为SUCCESS时获取Base64图像。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在生产环境或自建应用中调用腾讯混元文生图API批量生成图像，必须通过HTTP POST请求提交结构化任务参数，不能依赖网页界面点击操作。
获取API密钥与接入点
登录腾讯云控制台 → 进入【AI与大模型】→ 找到【混元文生图】服务 → 点击【管理密钥】→ 创建新密钥对，保存好SecretId和SecretKey。这一步漏掉就无法鉴权，后续所有请求都会返回401错误。
确认当前可用的API接入地址为：https://hunyuan.tencentcloudapi.com。注意不是官网hunyuan.tencent.com，也不是元器平台域名。
构造标准请求头
使用POST方法，Content-Type必须设为application/json; charset=utf-8。
在Headers中添加三项必填字段：
· X-Tencent-Cloud-Product: hunyuan
· X-Tencent-Cloud-Version: 2024-05-17
· Authorization: 使用TC3-HMAC-SHA256签名算法生成，不可直接拼接SecretKey——【手动生成签名极易出错，必须用腾讯云SDK自动签】
组装请求体（JSON Payload）
Body中至少包含以下四个键值对：
"Model": "hunyuan-image-3.0",
"Prompt": "一只穿宇航服的橘猫站在月球表面，背后是地球升起，超高清写实风格",
"Size": "1024x1024",
"N": 2
Size字段只接受预设组合：1024x1024、1792x1024、1024x1792、768x768；填错如"1024*1024"或"1kx1k"会导致400报错且不提示具体原因。
N表示单次请求生成图片数量，取值范围是1～4；超过4会直接拒绝，不会降级处理。
发送请求并解析响应
用curl、Postman或代码发起POST请求，成功时返回HTTP 200，Body中含TaskId字段，形如"task-abc123xyz"。
立即用该TaskId调用GET接口https://hunyuan.tencentcloudapi.com/?Action=DescribeTaskResult&TaskId=task-abc123xyz轮询结果，轮询间隔不得短于2秒——【高频轮询触发限流后，该TaskId将永久失效】
当Status字段变为"SUCCESS"，Images数组中即为Base64编码的PNG图像数据，每个元素对应一张图。解码后即可保存为文件或转为URL分发。
