SuperAPI AI 工具集

hy-image-generation

设计与创作

查看项目

更新于 10-26 20:31

技能介绍

腾讯云混元生图 Skill 基于腾讯混元大模型,提供文本生成图像与图生图能力,可根据文本描述生成贴合内容的 AI 图像。

【主要能力】 支持垫图引导,可传入最多 3 张参考图片 URL 引导生图方向,支持 jpg、jpeg、png、webp 格式,每张图片经 base64 编码后不超过 10MB。支持自定义分辨率,宽度和高度需在 512 至 2048 像素范围内,且宽 × 高不超过 1024×1024 像素,默认为 1024:1024。Prompt 改写默认开启,可自动优化提示词以获得更好效果,会增加约 20 秒耗时。支持 Seed 固定随机种子,便于复现生成结果。

【使用方式】 本 Skill 提供三个核心脚本:scripts/main.py 为一站式生图脚本,提交任务并自动轮询等待结果,推荐默认使用;scripts/submit_job.py 仅提交任务并返回 JobId;scripts/query_job.py 根据 JobId 查询或轮询任务状态和结果。脚本支持可选参数,包括 --images 传入垫图 URL、--resolution 设置分辨率、--seed 设置随机种子、--revise 控制 Prompt 改写开关、--no-poll 仅提交或仅查询一次;query_job.py 还支持 --poll-interval 与 --max-poll-time 控制轮询。也可通过 --stdin 以 JSON 形式传入参数。

【环境要求与配置】 需要 Python 3.7+ 与 tencentcloud-sdk-python,首次运行脚本会自动安装依赖。使用前需在腾讯云控制台开通混元生图服务,获取 API 密钥后通过环境变量 TENCENTCLOUD_SECRET_ID 与 TENCENTCLOUD_SECRET_KEY 配置,脚本会优先从环境变量读取并进行凭证检测。

【输出与限制】 普通生图通常 10 至 30 秒完成,开启 Prompt 改写会额外增加约 20 秒。生成的图片 URL 有效期为 1 小时,需要及时保存。调用失败时应返回明确错误说明,不应编造图片 URL 或生成结果。详细的参数说明与错误码可参阅 references/ 目录下的提交生图任务与查询生图任务 API 文档。