由 webkubor 打造 — 一句描述，一张好图。
一键智能出图 CLI，基于 OpenAI Codex CLI (GPT Image 2) 引擎。
无需 API Key，零配置，支持文生图与图生图，内置多场景 Skill 模板。
古装人物肖像 —
image-codex-cli generate --skill costume-portrait --prompt "唐朝仕女，手持团扇，红墙绿瓦背景"
角色参考图（基于参考图生成三视图+表情+色板）
image-codex-cli generate --skill character-sheet -i reference.jpg --prompt "日系少女，马尾长发"
# 安装 Codex CLI + image-codex-cli
npm install -g @openai/codex image-codex-cli
codex login
# 验证环境
image-codex-cli check
# 出图（文生图）
image-codex-cli generate --prompt "一只橘猫在雨天窗台上"
# 出图（带 Skill）
image-codex-cli generate --skill costume-portrait --prompt "唐朝仕女"
# 出图（图生图 — 带参考图）
image-codex-cli generate --skill character-sheet -i character.jpg --prompt "赛博朋克女忍者"无需 API Key。 只需安装 Codex CLI 并登录你的 ChatGPT (Plus/Pro) 账号即可出图。
CLI 启动时自动注册以下 Skill，直接使用 --skill <name> 调用：
| Skill | 用途 | 比例 | 参考图 | 分类 |
|---|---|---|---|---|
character-sheet |
🎯 角色设定资料卡 — 三视图+表情+装备分解+色板 | 16:9 | ✅ 必须 | character |
character-sheet-duo |
🎯 双角色对比设定资料卡 | 16:9 | ✅ 必须 | character |
costume-portrait |
🎯 古装/戏服人物肖像 | 3:4 | ✅ 可选 | character |
social-cover |
🎯 小红书/社交媒体封面 | 3:4 | ✅ 可选 | social |
ui-mockup |
🎯 UI 设计系统 — App/Web 界面 | 16:9 | ✅ 可选 | ui |
ecommerce-lifestyle |
🛒 场景/生活图 — 产品实拍感 | 4:3 | ✅ 可选 | product |
ecommerce-packaging |
🛒 包装/礼盒展示 — 开箱视觉 | 1:1 | ✅ 可选 | product |
product-photo |
🎯 产品展示图 — 电商摄影 | 1:1 | ✅ 可选 | product |
product-detail |
🎯 商品详情图 — 多角度细节标注 | 16:9 | ✅ 必须 | product |
brand-identity |
🏷️ 品牌视觉系统 — Logo+色板+字体+样机 | 16:9 | ✅ 可选 | brand |
poster-double-exposure |
🎨 水墨双重曝光海报 | 3:4 | ✅ 可选 | poster |
commercial-poster |
🎯 商业落地海报 — 促销/品牌含文字 | 3:4 | ✅ 必须 | poster |
infographic-engine |
📊 信息图/知识卡片 — 图解知识 | 16:9 | ✅ 可选 | poster |
film-storyboard |
🎯 电影分镜图 — 多格+机位标注 | 16:9 | ✅ 可选 | poster |
✅ 可选 = 不传参考图也能出图（文生图模式） ✅ 必须 = 需要传参考图才能出图（图生图模式）
当使用 -i / --input-image 参数时，CLI 自动切换为图生图模式：
# 单参考图
image-codex-cli generate --skill character-sheet -i ref.jpg --prompt "武侠少女"
# 多参考图（传产品图+Logo 做海报）
image-codex-cli generate --skill commercial-poster -i product.jpg -i logo.png --prompt "618 年中大促"
# 不加参考图就是文生图
image-codex-cli generate --skill social-cover --prompt "电子书推荐"每个 Skill 内置 refImageInstruction（参考图使用说明），自动注入 prompt 末尾告知模型如何利用参考图。例如 character-sheet 的指令：
"参考图中的角色形象、服装风格和世界观设定是核心依据。在角色参考图中必须严格遵循参考图的人物外观（发型、脸型、体型、肤色），同时按照角色参考图规范生成三视图、表情变化、装备分解和色板。"
| 你说 | 执行 |
|---|---|
| "帮我做角色参考图" | --skill character-sheet -i 角色图.jpg |
| "帮我做张古装人物" | --skill costume-portrait |
| "帮我做小红书封面" | --skill social-cover |
| "帮我做 UI 素材" | --skill ui-mockup |
| "帮我做产品图" | --skill product-photo |
| "帮我做商品详情图" | --skill product-detail -i 产品图.jpg |
| "帮我做促销海报" | --skill commercial-poster -i 产品图.jpg -i logo.png |
| "帮我做电影分镜" | --skill film-storyboard |
| "帮我把这个角色做成设定卡" | --skill character-sheet -i 参考图.jpg |
# 使用默认 profile
image-codex-cli generate --prompt "neon Tokyo street at night, rain"
# 指定比例
image-codex-cli generate --prompt "wide city skyline" --aspect-ratio 16:9
# 使用预设 profile
image-codex-cli generate --prompt "product shot" --profile avatar
# 批量出图
image-codex-cli generate --prompt "abstract art" --output-count 4| Flag | 默认 | 说明 |
|---|---|---|
--prompt |
必填 | 图片描述 |
--skill |
— | 使用内置 Skill 模板 |
-i, --input-image |
— | 参考图路径（可重复使用，图生图模式） |
--profile |
当前默认 | 使用指定 profile |
--no-expand |
false | 跳过 prompt 自动扩展 |
--aspect-ratio |
按 profile | 16:9 9:16 1:1 3:4 21:9 |
--provider |
codex |
codex gemini |
--output-count |
1 | 1–8 张 |
--filename |
系统默认目录 | 输出路径 |
--seed |
— | 锁定随机种子 |
# 添加
image-codex-cli skill add \
--name cover \
--description "Editorial blog cover" \
--prompt-template "{{prompt}}, editorial cover, strong headline-safe negative space" \
--aspect-ratio 16:9
# 查看
image-codex-cli skill list
image-codex-cli skill show cover
# 调用
image-codex-cli skill run cover --prompt "AI tools for designers"git clone https://github.com/webkubor/image-codex-cli
cd image-codex-cli
npm install && npm run build
node bin/image-codex-cli.js check由 webkubor（栖洲） 创建并维护。基于 OpenAI Codex CLI 和 GPT Image 2 模型。
"沉淀 AI 时代的视觉生产力工具。"
License: Apache 2.0