要获取腾讯混元文生图api生成图片的真实可访问url,需区分同步与异步接口:同步接口(hy-image-3.0)仅返回base64数据,须自行解码保存并上传至cdn或cos获取url;异步接口(旧版高级版)在任务完成后的resulturls字段中返回1小时内有效的临时url;tokenhub的hy-image-v3.5-preview需开通cos直传权限并设置rspimgtype=image_url参数,方可直接返回imageurl字段。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要拿到腾讯混元文生图API生成的图片真实可访问URL,必须区分同步接口与异步接口两种路径——同步调用直接返回Base64图像数据,不带URL;异步调用才在查询结果中返回带有效期的ResultUrls数组。
同步接口(Hy-Image-3.0):从Base64转存为本地文件或上传至自有CDN
调用 https://tokenhub-intl.tencentcloudmaas.com/v1/wand/hunyuan-image/v3-generation 后,响应体 JSON 中的 image 字段是纯 Base64 编码字符串,【不包含任何URL字段】。
将 Base64 字符串解码为二进制数据,保存为 .png 文件即可查看。Python 示例:with open("output.png", "wb") as f: f.write(base64.b64decode(response["image"]))。
若需对外提供图片链接,须自行将该文件上传至对象存储(如 COS)、CDN 或任意支持 HTTP 访问的静态资源服务,再获取其公开 URL。
异步接口(旧版文生图高级版):查询任务后提取 ResultUrls
第一步:调用提交接口 https://aiart.tencentcloudapi.com/v2022-12-29/ → 获取 JobId(例如 d33c2c966ae1476a5fae5e76)。
第二步:轮询查询接口 QueryTextToImageJob,传入该 JobId,直到 JobStatusCode 变为 DONE。
第三步:从返回 JSON 的 ResultUrls 字段取值——这是一个字符串数组,每个 URL 有效期仅 1 小时,格式类似:https://aiart-xxx.cos.ap-guangzhou.myqcloud.com/xxx?q-sign-algorithm=sha1&q-ak=xxx&...。
【注意:ResultUrls 中的 URL 不可长期缓存,必须在1小时内下载或二次上传,否则链接失效】
TokenHub + Hy-Image-V3.5-Preview:无原生URL,但支持 RspImgType=image_url(需额外开通)
方法一:在请求体中显式添加 "RspImgType": "image_url" 参数,并确保账号已开通 COS 存储桶自动写入权限。成功后响应中会出现 imageUrl 字段。
方法二:不加该参数时,默认仍返回 Base64;加了但未开通权限,接口会报错 InvalidParameter.RspImgType。
这一步必须提前在 TokenHub 控制台 → 视觉模型页 → 点击 Hy-Image-V3.5-Preview 右侧“配置” → 勾选“启用图片直传COS并返回URL”选项,否则参数无效。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











