必须通过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中至少包含以下四个键值对：

腾讯混元

腾讯混元是由腾讯公司推出的通用大语言模型与AI助手产品，基于自研的混元大模型体系打造，提供智能问答、内容生成、代码辅助、办公写作、知识检索等能力。用户可以通过网页端、移动端等方式使用，用于学习、工作和内容创作等多种场景。

下载

"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分发。

大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！