用途:把一句话提示词变成2K高清图片,底层调用Gitee AI Serverless API的z-image-turbo模型(8步生成),每天约100张免费额度,只需一个免费令牌,不依赖付费服务。支持图标、封面、插画、海报、头像等文生图需求;仅限文生图,编辑现有图片或图生图需求应改用freeimg-hunyuan技能。
首次使用需配置免费令牌:登录ai.gitee.com/serverless-api,在任意模型详情页点「在线体验」→「API」→「添加令牌」→复制。令牌读取优先级为环境变量GITEE_AI_API_KEY,其次本地配置文件~/.freeimg-z-image/config.env(一行GITEE_AI_API_KEY=xxxx,chmod 600)。不要把令牌写进仓库、日志或对话输出。
生成命令:scripts/generate.mjs --prompt "提示词" --out 输出.png [--width 1024] [--height 1024] [--steps 8] [--negative "负向提示词"]。宽高必须为8的倍数,常用组合:1:1用1024×1024或2048×2048,4:3横图2048×1536,3:4竖图1536×2048,16:9宽图2048×1152;--steps默认8,越高越慢;--negative不传时默认文字,字母,水印,签名,模糊。接口偶发502,脚本内置2次退避重试。生成后应先查看图片确认质量再交付,需要小尺寸可用sips -Z或ImageMagick convert -resize缩放。提示词用中文即可,结构为风格+主体+细节+构图+无文字无水印。
环境变量:GITEE_AI_API_KEY(令牌)、FREEIMG_Z_IMAGE_CONFIG(自定义配置文件路径)。
限制:模型对文字渲染不稳定,需文字时后期用设计工具添加;单日约100张免费额度,报429/403时提示用户明天再试或换令牌;需网络可达Gitee AI;畸形手部或构图偏移需重新生成。可视化网页版freeimg.shenzjd.com提供18000+提示词库、12种预设风格、7种尺寸比例、历史记录与图床上传,与技能共用同一令牌。