必须填写secretid和secretkey并用sdk生成authorization签名,action=texttoimagelite、version=2022-12-29、region如ap-guangzhou、prompt为中文描述,style传整数编号(如101)而非字符串,成功后凭taskid轮询获取imageurl。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要用代码调用腾讯混元文生图轻量版接口生成图片,但没写清楚密钥怎么填、参数怎么传、风格编号怎么选,直接发请求会报错或返回空图。
开通服务并获取API密钥
登录腾讯云控制台 → 进入 TokenHub 页面 → 找到「混元文生图轻量版」→ 点击「立即开通」→ 同意服务条款后,系统自动分配调用权限。
在「接入管理」页面创建一个新的 API Key,记下生成的 【SecretId】 和 【SecretKey】;SecretKey 只显示一次,关闭页面就再也看不到,务必立刻复制保存。
确认接口地址与认证方式
文生图轻量版使用的是 API 3.0 标准协议,请求地址为:
https://aiart.tencentcloudapi.com/
必须携带签名认证头 Authorization,格式为:
Authorization: TC3-HMAC-SHA256 Credential={SecretId}/{date}/{region}/aiart/tc3_request, SignedHeaders=content-type;host, Signature={signature}
这一步不能手算签名,必须用官方 SDK 或 API Explorer 自动生成。自己拼接 Authorization 极易出错,会导致 401 错误。
构造请求参数(核心四要素)
调用接口必须包含以下四个参数,缺一不可:
① Action:固定填 【TextToImageLite】
② Version:固定填 【2022-12-29】
③ Region:选一个支持地域,比如 【ap-guangzhou】(广州)或 【ap-beijing】(北京),不能填错,否则提示地域不支持
④ Prompt:中文描述,最多 256 字符,不能为空。例如:“一只橘猫趴在窗台上,阳光洒落,背景是樱花树”
设置风格编号(选填但强烈建议)
方法一:直接用预置风格编号(推荐)
查「文生图轻量版风格列表」,选中风格后把对应编号填入 Style 参数。例如要水墨画效果,Style 填 【101】;要赛博朋克,填 【113】。
方法二:Prompt 内嵌风格词(兼容但不稳定)
Style 填 【000】,然后在 Prompt 开头加风格描述,例如:“水墨画风格,一只仙鹤飞过黄山云海”。注意:这种写法容易被模型忽略,生成效果波动大。
注意:Style 参数不是字符串而是数字类型,传 "101" 会失败,必须传整数 101。
发起 POST 请求并解析响应
用 curl 或 Python requests 发送 POST 请求,Body 是 JSON 格式,包含上述所有参数(Action、Version、Region、Prompt、Style 等),Header 中必须有 Content-Type: application/json 和正确的 Authorization。
成功响应里会返回 TaskId 字段,这是后续轮询结果的唯一凭证。
调用 【QueryTextToImageLite】 接口,传入该 TaskId,等待 status 字段变为 "Success",再从 Response.ImageUrl 字段提取生成图的可访问链接。










