ai-image-gen Skill

通用 AI 文生图 / 图生图 / 图像变体。用户自备图像生成 API key（OpenAI 兼容 或 apimart 异步），产物写入 outputs/。

调用共享脚本 skills/shared/scripts/ai_image.py（纯标准库，无第三方依赖）。 本 SKILL 不索要、不回显、不写入、不提交任何真实 API key, , key 只存在于用户自己的 .env。

边界（和相邻 SKILL 区分）

• ai-image-gen（本 SKILL）：通用 AI 生图，任意题材，文生图 / 图生图 / 变体。
• ecom-details-image：电商详情页 / 商品主图专用出图（25 场景模板、PDP 序列）。要做电商商品图走它。
• card-* / poster-*：HTML+CSS 渲染截图（金句卡、小红书卡、海报），非 AI 生成，是确定性设计出图。
• image-editing：已有图片的确定性处理（改尺寸/裁剪/加水印/压缩），不生成新画面。

配置（执行前必读）

配置检查路径铁律：先 cd 到运行时说明给出的 Easel 项目根，确认当前目录有 .env 和 skills/shared/scripts/ai_image.py，再运行下列命令。不得在任何执行引擎的 workspace 或共享脚本副本中检查，也不得用 env / printenv 代替读取项目 .env；否则会把已配置的 IMG_BASE_URL/Key 误判为缺失。

需在项目根目录 .env 中设置三项（脚本从当前目录向上自动查找 .env）：

变量	说明	兼容别名
IMG_BASE_URL	API 根地址	OPENAI_BASE_URL / OPENAI_API_BASE / BASE_URL
IMG_MODEL	图片模型名	OPENAI_IMAGE_MODEL / IMAGE_MODEL / OPENAI_MODEL
IMG_API_KEY	API key	OPENAI_API_KEY / API_KEY

支持两类服务，脚本按 base_url 自动检测（也可 --mode sync|async 强制）：

• OpenAI 兼容（同步）：base_url 不含 apimart。走 /images/generations、/images/edits、/images/variations。 示例：IMG_BASE_URL=https://api.openai.com/v1，IMG_MODEL=gpt-image-1。
• apimart（异步轮询）：base_url 含 apimart。提交任务 → 轮询 /tasks/<id> → 下载。 示例：IMG_BASE_URL=https://api.apimart.ai/v1。

执行步骤

1. 先确认配置（离线，不发请求）

python skills/shared/scripts/ai_image.py check

打印三项配置状态（key 脱敏显示）、命中的别名、自动检测的模式。缺项时给出 .env 填写示例并以退出码 2 结束。配置未就绪就不要往下走，直接把缺什么、怎么配告诉用户。

2. 文生图 text2img

先把用户诉求写成一条清晰的图像 Prompt（主体 + 风格 + 构图 + 光线 + 画质），再执行：

python skills/shared/scripts/ai_image.py text2img \
  --prompt "一只戴墨镜的柴犬，扁平插画风，明亮撞色背景，高细节" \
  --size 1024x1024 --n 1 \
  --output outputs/主题名/ai-image