Install
openclaw skills install @thcjp/ai-image-gen-tool-freeopenclaw skills install @thcjp/ai-image-gen-tool-freeAI图像生成免费版是一款面向个人用户的文本生成图像工具。通过自然语言描述即可生成高质量图片,支持多种画幅比例与标准分辨率,无需绘画基础,几秒钟即可获得原创图像。
本版本依托 Gemini Flash Image 模型能力,提供基础的文生图功能,支持社交媒体头像、配图、创意灵感等多种场景,适合个人创作者快速产出图像内容。
| 能力项 | 免费版支持 | 说明 |
|---|---|---|
| 文本生成图片 | 是 | 输入描述生成图像 |
| 多比例支持 | 是 | 1:1/3:2/16:9 等 10 种 |
| 标准分辨率 | 是 | 基础清晰度 |
| 2K 分辨率 | 限制 | 部分比例支持 |
| 4K 分辨率 | 否 | PRO 版支持 |
| 图生图(图+文) | 否 | PRO 版支持 |
| 风格转换 | 否 | PRO 版支持 |
| 批量生成 | 否 | PRO 版支持 |
技术实现要点:核心能力基于input_params参数与output_format配置实现,支持创建/查询/修改/删除等操作模式,通过config_options进行运行时配置。 |
用input_params参数进行配置。
输入: 用户提供核心功能执行所需的指令和必要参数。 处理: 按照skill规范执行核心功能执行操作,遵循单一意图原则。 输出: 返回核心功能执行的执行结果,包含操作状态和输出数据。
input_params参数,支持创建/查询/导出操作用config_options参数进行配置。
输入: 用户提供参数配置与调用所需的指令和必要参数。 处理: 按照skill规范执行参数配置与调用操作,遵循单一意图原则。 输出: 返回参数配置与调用的执行结果,包含操作状态和输出数据。
config_options参数,支持修改/重置/导入操作用output_format参数进行配置。
输入: 用户提供结果处理与输出所需的指令和必要参数。 处理: 按照skill规范执行结果处理与输出操作,遵循单一意图原则。 输出: 返回结果处理与输出的执行结果,包含操作状态和输出数据。
output_format参数,支持导出/保存/转换操作
能力覆盖范围:本skill的核心能力覆盖以下场景关键词:通过文本描述生成、支持多种比例与标、适合个人创作者快、速出图、图像生成免费版、面向个人用户的文、本生成图像工具、文本描述生成图片、文生图、等多种比例、标准分辨率输出、满足社交媒体与基、础设计需求、多风格支持、赛博朋克、写实摄影等等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。用户需要一个独特的社交媒体头像,生成一张 1:1 的艺术风格图片。
python3 scripts/generate_image.py \
"一只戴着圆框眼镜的橘猫,水彩风格,柔和色调,简洁背景" \
--model gemini-3.1-flash-image \
--output avatar.png
内容创作者为短视频制作 16:9 横版封面图。
python3 scripts/generate_image.py \
"未来都市夜景,霓虹灯光,赛博朋克风格,雨后湿润街道反射,电影感构图" \
--model gemini-3.1-flash-image-16x9 \
--output video_cover.png
设计师希望快速将一个创意概念可视化,用于灵感记录。
python3 scripts/generate_image.py \
"一座漂浮在云端的图书馆,书籍如瀑布般倾泻而下,暖色调,梦幻氛围,吉卜力风格" \
--model gemini-3.1-flash-image-3x2 \
--output inspiration.png
以下场景AI图像生成-免费版不适合处理:
需要AI模型调用、智能对话、Agent编排、LLM应用时使用。不适用于非本工具能力范围的需求。
export IMAGE_GEN_API_KEY="your_api_key_here"
export IMAGE_GEN_BASE_URL="https://code.newcli.com/gemini"
python3 scripts/generate_image.py \
"你的提示词描述" \
--model gemini-3.1-flash-image \
--output output.png
生成的图片保存在 --output 指定路径,直接展示给用户即可。
基础配置项说明:
# 环境变量
IMAGE_GEN_API_KEY=your_key # 必填
IMAGE_GEN_BASE_URL=https://code.newcli.com/gemini # 默认值
# 常用参数组合
# 1:1 头像
--model gemini-3.1-flash-image
# 16:9 横版
--model gemini-3.1-flash-image-16x9
# 9:16 竖版(手机壁纸)
--model gemini-3.1-flash-image-9x16
# 2K 高清(部分比例)
--model gemini-3.1-flash-image-2k-16x9
| 模型 ID | 比例 | 适用场景 |
|---|---|---|
| gemini-3.1-flash-image | 1:1 | 社交媒体头像 |
| gemini-3.1-flash-image-3x2 | 3:2 | 横版照片 |
| gemini-3.1-flash-image-2x3 | 2:3 | 竖版海报 |
| gemini-3.1-flash-image-4x5 | 4:5 | |
| gemini-3.1-flash-image-9x16 | 9:16 | 手机壁纸/短视频 |
| gemini-3.1-flash-image-16x9 | 16:9 | 电脑壁纸/视频 |
| gemini-3.1-flash-image-21x9 | 21:9 | 超宽屏 |
A:免费版默认标准分辨率,可尝试使用 2K 模型(如 gemini-3.1-flash-image-2k-16x9)。如需 4K 超高清,请使用 PRO 版。
A:建议控制在 500 字以内,过长的提示词可能影响生成效果。核心元素前置描述。
A:可以,但请避免生成真实公众人物的肖像,以免涉及版权与肖像权问题。
A:检查 API Key 是否正确;确认网络可访问 API 地址;尝试简化提示词后重试。
A:API 调用受服务商配额限制,免费版配额较低。如需高频调用或批量生成,请使用 PRO 版。
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| Gemini Image API | 外部 API | 必需 | 服务商申请 |
| Python 3.8+ | 运行时 | 必需 | 官方安装 |
| requests | Python 库 | 必需 | pip install requests |
| Pillow | 图像处理 | 推荐 | pip install Pillow |
IMAGE_GEN_API_KEYIMAGE_GEN_BASE_URL(可选,有默认值).env 文件或系统环境变量,避免硬编码到脚本| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令,参考国内替代方案 |