FreeImg 是一款文生图工具，底层调用 Gitee AI Serverless API 的 z-image-turbo 模型（8 步极速生成），把一句话提示词变成 2K 高清图片，每天约 100 张免费额度，仅需一个免费令牌，不依赖付费服务。
用途：适合生成图标、封面、插画、海报、头像等图片。当用户要求画图、生成图片、AI 绘画、生成头像或封面时使用。它只做文生图，不编辑已有图片；若用户明确需要其他模型（如 DALL·E、Midjourney、Flux），应改用对应工具；无网络或 Gitee AI 不可达时不可用。
主要能力：支持分辨率与步数参数调节；--width/--height 必须为 8 的倍数；--steps 默认 8；--negative 不传时默认排除“文字,字母,水印,签名,模糊”。常用尺寸包括 1:1（1024×1024，高清 2048×2048）、4:3（2048×1536）、3:4（1536×2048）、16:9（2048×1152）。提示词用中文即可，模型中文理解良好。
使用方式：首次配置免费令牌，令牌按优先级从环境变量 GITEE_AI_API_KEY 或本地配置文件 ~/.freeimg/config.env 读取，都没有时脚本会打印获取引导并退出，需引导用户完成配置，令牌写入该文件并 chmod 600。生成命令示例：scripts/generate.mjs --prompt "提示词" --out 输出.png
[--width 1024] [--height 1024] [--steps 8] [--negative "负向提示词"]。生成后应先用 Read 工具查看图片确认质量再交付，不满意就换提示词重生成。需要小尺寸时可用 sips -Z 144 原图 --out 小图.png（macOS）或 ImageMagick convert -resize 缩放。环境变量还有 FREEIMG_CONFIG 用于自定义配置文件路径。接口偶发 502，脚本内置 2 次退避重试。
另有可视化网页版 freeimg.shenzjd.com，内置 18000+ 精选提示词库、12 种预设风格、7 种尺寸比例、历史记录与图床上传，与 Skill 共用同一令牌。
限制与注意事项：不要把令牌写进仓库、日志或对话输出，.env 文件应 gitignore；尺寸不是 8 的倍数会被拒绝或静默取整；z-image 对文字渲染不稳定，需要文字时后期用设计工具添加，提示词里声明“无文字”；模型偶尔产出畸形手部或构图偏移，必须先检查再交付；单日约 100 张免费额度，报 429/403 时提示用户明天再试或换令牌。