调用 OpenAI 最新的 gpt-image-2 模型生成高质量图片。粘贴提示词就能用。
> Skill 特色
>
> - 支持命令行批量生成、参数化控制尺寸/格式/背景
> - 文生图 + 图生图双模式,--image 一个参数启用编辑模式
> - 内置公共 API Key,约 10000 次免费额度,开箱即用无需注册
# 基本生成
python3 "$SKILL_PATH/assets/imagegen.py" "一只橘色的猫咪坐在窗台上看着窗外的夕阳"
# 横版高清
python3 "$SKILL_PATH/assets/imagegen.py" "futuristic city skyline" --size 1792x1024
# 透明背景 logo
python3 "$SKILL_PATH/assets/imagegen.py" "minimalist cat logo, flat design" --bg transparent --format png
# 批量生成 4 张
python3 "$SKILL_PATH/assets/imagegen.py" "icon set, flat style" -n 4 --bg transparent
# WebP + 压缩
python3 "$SKILL_PATH/assets/imagegen.py" "product photo on white background" --format webp --compression 50
# 基于参考图修改(自动上传图片 → 编辑生成)
python3 "$SKILL_PATH/assets/imagegen.py" "把猫咪改成白色,背景换成星空" --image ~/Pictures/cat.png
# 风格迁移,高保真
python3 "$SKILL_PATH/assets/imagegen.py" "改成赛博朋克风格" --image ref.jpg --fidelity high
# 低保真,大幅改动
python3 "$SKILL_PATH/assets/imagegen.py" "变成水彩画风格,加入樱花元素" --image photo.png --fidelity low
# 仅提交任务(返回 taskId,不等待)
python3 "$SKILL_PATH/assets/imagegen.py" "complex scene" --no-download
# 查询已有任务结果
python3 "$SKILL_PATH/assets/imagegen.py" "" --task-id sfwmpic7xxxxxxxx
# 指定输出目录和文件名前缀
python3 "$SKILL_PATH/assets/imagegen.py" "illustration" -o ~/Pictures/AI --prefix artwork
| 参数 | 说明 | 默认值 |
|---|---|---|
| ------ | ------ | -------- |
prompt | 生成/编辑提示词(必填,最多 500 字) | - |
--image | 参考图路径(启用图生图模式) | - |
--fidelity | 图生图保真度:high / low | - |
--size | 尺寸(仅支持白名单分辨率) | 1024x1792 |
-n, --count | 生成数量(1-10) | 1 |
--quality | 质量:low / medium / high / auto | medium |
--format | 格式:png / jpeg / webp | png |
--bg | 背景:transparent / opaque / auto | auto |
--compression | 压缩比(0-100) | 0 |
-o, --output-dir | 输出目录 | ~/Downloads/QoderImages |
--prefix | 文件名前缀 | image |
--no-download | 仅提交不等待 | - |
--task-id | 查询已有任务 | - |
--api-key | 指定 API Key | - |
| 依赖 | 安装命令 |
|---|---|
| ------ | ---------- |
requests | pip3 install requests |
先配置 API Key,然后运行:
python3 "$SKILL_PATH/assets/imagegen.py" "一只橘色的猫咪"
前往 redfox.hk 注册账号获取自己的 API Token,三种配置方式任选其一:
| 配置方式 | 说明 | 命令 |
|---|---|---|
| ---------- | ------ | ------ |
| 环境变量(推荐) | 设置一次,全局生效 | export REDFOX_API_KEY=ak_你的密钥 |
| 命令行参数 | 临时使用,单次生效 | python3 "$SKILL_PATH/assets/imagegen.py" "prompt" --api-key ak_你的密钥 |
| 配置文件 | 持久化存储,跨会话保留 | mkdir -p ~/.qoder/apis && echo '{"api_key":"ak_你的密钥"}' > ~/.qoder/apis/redfox.json |
Q:本 Skill 的特点是什么?
A:命令行直接调用 gpt-image-2 模型,支持批量生成、参数化控制、图生图编辑,
Q:生成一张图片需要多久?
A:通常 10-30 秒,复杂场景可能更久。脚本会自动轮询等待。
Q:图生图的保真度怎么选?
A:--fidelity high 尽量保留原图细节(微调),--fidelity low 允许大幅改动(风格迁移)。不传则由模型自行判断。
Q:如何生成透明背景图?
A:使用 --bg transparent,搭配 PNG 或 WebP 格式(JPEG 不支持透明)。
Q:额度用完了怎么办?
A:前往 redfox.hk 注册获取自己的 API Token。
Q:支持哪些图片格式作为参考图?
A:支持 PNG、JPEG、WebP 格式的本地图片文件。
Q:支持自定义分辨率吗?
A:仅支持以下测试验证过的分辨率,其他分辨率可能导致生成过慢或失败:
Q:提示词有长度限制吗?
A:提示词最多支持 500 字,超过会被阻断并提示精简。
共 6 个版本