只需开通混元生图服务、获取SecretId/SecretKey，终端用curl提交prompt即可一键生图：先调submit接口获TaskId，再用query接口轮询ResultUrl；支持API Explorer零代码调试，提示词需包含风格/主体/动作/背景四要素。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想用腾讯混元生图快速生成一张符合描述的图片，不需要打开网页反复调试，也不必写完整 SDK 代码——只要准备好提示词、开通服务、拿到密钥，终端里敲一行命令就能出图。
开通服务并获取密钥
登录腾讯云控制台 → 进入混元生图服务页 → 点击“立即开通”完成服务启用。这一步必须做完，否则后续所有调用都会返回 UnauthorizedOperation 错误。
开通后，在访问管理 → API密钥管理中创建一对 SecretId 和 SecretKey。注意：【SecretKey 只在创建时显示一次，关闭页面即不可找回】，务必复制保存到安全位置。
若使用子账号，请主账号进入 CAM 控制台 → 用户列表 → 找到对应子用户 → 授权策略 QcloudAIARTFullAccess。
用 curl 提交文生图任务（最简方式）
打开终端，执行以下命令（将 YOUR_SECRET_ID、YOUR_SECRET_KEY 和 YOUR_PROMPT 替换为实际值）：
curl --location 'https://aiart.tencentcloudapi.com/v1/aiart/submit' \--header 'Authorization: sk-YOUR_SECRET_ID:YOUR_SECRET_KEY' \--header 'Content-Type: application/json' \--data '{ "model": "HY-Image-V3.0", "prompt": "YOUR_PROMPT", "size": "1024:1024" }'
例如 prompt 填 “一只戴眼镜的柴犬坐在书桌前写代码，赛博朋克风格，霓虹蓝紫光效”，提交后会立即返回 JSON 响应，其中 TaskId 是关键字段，用于查结果。
这一步不依赖任何 SDK 或配置文件，纯 HTTP 调用，适合脚本集成或临时测试。
查询生成结果
拿到 TaskId 后，用它去轮询结果接口：
执行：curl --location 'https://aiart.tencentcloudapi.com/v1/aiart/query' \--header 'Authorization: sk-YOUR_SECRET_ID:YOUR_SECRET_KEY' \--data-urlencode "TaskId=YOUR_TASK_ID"
响应中 Status 字段为 Success 时，ResultUrl 就是可直接访问的图片地址。如果返回 Processing，需等待几秒后重试——混元生图(3.0) 默认单并发，排队是正常现象。
注意：【TaskId 有效期为24小时，过期后无法再查】，建议拿到就立刻查，不要存着等第二天。
用 API Explorer 在线调试（零代码）
方法一：进入API Explorer 页面 → 选择接口 TextToImage → 粘贴 SecretId/SecretKey → 在 Prompt 栏输入描述 → 点击“发起请求”。
方法二：在混元生图控制台右上角点击「API Explorer」快捷入口，自动带入已授权上下文，省去手动填密钥步骤。
这个方式适合第一次试用，能实时看到请求参数结构、错误码说明和成功示例，比看文档更快定位问题。
提升生成质量的关键设置
第一步：在 prompt 中明确风格、主体、动作、背景四要素。例如不要只写“猫”，而要写“一只蹲在窗台上的英短蓝猫，正回头凝视镜头，柔焦虚化窗外雨景，胶片摄影风格”。混元生图(3.0) 对长 prompt 支持更好，千字级语义可解析。
第二步：开启 prompt 自动扩写（默认已开）。如需关闭，加参数 "revise": 0；但上传了参考图时该开关强制失效——这是模型设计逻辑，不是 bug。
第三步：指定分辨率。支持 1024:1024（正方）、1024:768（横图）、768:1024（竖图），不填则默认 1024:1024。其他尺寸如 2048:2048 暂不支持，会报错。
