by 运行时依赖
安装命令
点击复制技能文档
Free Image Gen - 免费AI图片生成工具
基于 Gitee AI API 的免费图片生成技能，支持多种模型，可将生成的图片保存到本地或上传到腾讯云 COS。
功能特点 🆓 完全免费 - 使用 Gitee AI API，无需付费 🎨 多模型支持 - 支持 Kolors 等多种图片生成模型 ☁️ 云端存储 - 可选上传到腾讯云 COS 📁 本地保存 - 支持保存到本地目录 🔧 灵活配置 - 配置参数可抽取到配置文件 安装依赖 pip 安装 -r requirements.txt
配置说明 方法一：首次使用交互式配置（推荐）
首次运行脚本时，如果检测到配置不存在，会自动进入交互式配置模式：
python scripts/mAIn.py --prompt "一只可爱的小狗"
系统会提示：
============================================================ Free Image Gen - 首次使用配置 ============================================================
检测到这是首次使用，需要配置 Gitee AI API Key
获取 API Key 的方法：
- 访问 https://AI.gitee.com/
- 注册/登录账号
- 进入控制台获取 API Key
------------------------------------------------------------
请输入你的 Gitee AI API Key: [用户输入API Key]
配置完成后，配置文件会自动保存到：~/.OpenClaw/技能s/技能-image-gen/config.json
方法二：通过对话配置（AI 代理 使用）
如果你是 AI 代理，可以通过对话获取用户的参数，然后使用 更新_config() 方法更新配置：
from config 导入 Config
# 创建配置对象（禁用交互式配置） config = Config(interactive=False)
# 通过对话获取用户的 API Key # user_API_key = ... (从对话中获取)
# 更新配置 config.更新_config('gitee.API_key', user_API_key)
# 现在可以使用配置了 API_key = config.获取('gitee.API_key')
方法三：环境变量
在 .env 文件中配置：
# Gitee AI API 配置 GITEE_API_KEY=your_gitee_API_key
# 腾讯云 COS 配置（可选） COS_SECRET_ID=your_secret_id COS_SECRET_KEY=your_secret_key COS_REGION=ap-guangzhou COS_BUCKET=your-bucket-name
# 输出目录 IMAGE_输出_PATH=./输出
方法四：手动创建配置文件
复制配置模板并修改：
cp config.example.json ~/.OpenClaw/技能s/技能-image-gen/config.json
配置文件查找优先级
脚本会按以下优先级查找配置文件：
环境变量：技能_IMAGE_GEN_CONFIG（最高优先级） 技能安装目录：~/.OpenClaw/技能s/技能-image-gen/config.json（优先） 独立技能配置目录：~/.OpenClaw/技能s/config/技能-image-gen/config.json（备选，卸载技能不影响配置） 当前工作目录： ./技能s/技能-image-gen/config.json ./.技能-image-gen/config.json 旧版全局配置：~/.OpenClaw/技能/技能-image-gen/config.json（向后兼容） 技能目录：config.json
找到第一个存在的配置文件就会加载，后续的路径会被忽略。
注意：推荐将配置文件放在 ~/.OpenClaw/技能s/config/ 目录下，独立于技能安装目录，卸载重装技能不会丢失配置。
配置文件示例
配置文件内容示例：
{ "gitee": { "API_key": "your_gitee_API_key", "模型": "Kolors", "base_url": "https://AI.gitee.com/v1" }, "cos": { "enabled": false, "secret_id": "", "secret_key": "", "region": "ap-guangzhou", "bucket": "" }, "输出": { "path": "./输出", "格式化": "png" } }
使用方法 基本用法 # 生成图片并保存到本地 python scripts/mAIn.py --prompt "一只可爱的小猫在阳光下睡觉"
# 指定输出路径 python scripts/mAIn.py --prompt "海边日落" --输出 ./images/sun设置.png
# 生成多张图片 python scripts/mAIn.py --prompt "山水画" --count 3
# 上传到 COS python scripts/mAIn.py --prompt "城市夜景" --上传-cos
命令行参数 参数 说明 默认值 --prompt, -p 图片生成提示词（必需） - --输出, -o 输出文件路径 自动生成 --模型, -m 使用的模型 Kolors --count, -n 生成图片数量 1 --上传-cos 上传到腾讯云 COS False --config, -c 配置文件路径 None（自动查找） --size, -s 图片尺寸 1024x1024 --json JSON 格式输出 False 作为模块使用 from scripts.gitee_API 导入 GiteeImage生成器
# 初始化 生成器 = GiteeImage生成器(API_key="your_API_key")
# 生成图片 结果 = 生成器.生成("一只可爱的小狗") print(结果["image_url"])
# 生成并上传 结果 = 生成器.生成( prompt="山水画", 上传_to_cos=True, 输出_dir="./images" )
获取 API Key 访问 Gitee AI 注册/登录账号 进入控制台获取 API Key 支持的模型 模型 说明 推荐场景 Kolors 快文生图模型 通用图片生成 flux-schnell 快速生成 简单场景 stable-diffusion 经典模型 艺术风格 目录结构 技能-image-gen/ ├── 技能.md # 本说明文件 ├── config.example.json # 配置示例文件 ├── scripts/ │ ├── mAIn.py # 主入口脚本 │ ├── config.py # 配置管理 │ ├── gitee_API.py # Gitee API 封装 │ ├── cos_上传er.py # COS 上传模块 │ └── utils.py # 工具函数 └── requirements.txt # Python 依赖
用户配置文件位置：~/.OpenClaw/技能s/技能-image-gen/config.json（推荐）
常见问题 Q: API Key 无效？
A: 请确认 API Key 是否正确，是否已激活。
Q: 图片生成失败？
A: 检查网络连接，确认 Gitee AI 服务是否正常。
Q: COS 上传失败？
A: 检查 COS 配置是否正确，Bucket 是否存在，权限是否正确。
注意事项 Gitee AI API 有调用频率限制，请合理使用 生成的图片默认保存为 PNG 格式 COS 上传需要提前创建 Bucket 并配置权限 更新日志 v1.0.0 - 初始版本，支持基本的图片生成功能