用途：根据文本提示调用 Leonardo AI 生成图片，支持一次生成多张，并自动完成模型选择、轮询、下载与费用记录。
主要能力：通过 POST https://cloud.leonardo.ai/api/rest/v2/generations 创建生成任务，轮询至完成，下载图片并写出 <name>.json，内含完整请求、模型决策、预估与实际费用、调用前后余额。默认生成 1 张（API 默认 4 张）。支持 --intent 指定用途（photo、portrait、product、text、illustration、icon、logo、anime、3d、cover、banner、draft），--model 强制模型（phoenix-v1.0、lucid-origin、lucid-realism、flux-dev、flux-schnell、anime-xl 等），--aspect/--size 设定比例或精确尺寸，--quantity 1 至 8，以及 --mode、--quality、--style、--negative、--seed、--enhance、--contrast 等模型选项。只读子命令包括 --estimate、--explain、--balance、--list-models、--status <id>。
使用方式：需设置 LEONARDO_API_KEY（Production API key，User API key 已不被接受），可从环境变量或 .env 读取。先运行 bash "$HOME/.claude/skills/generate-image/setup.sh" 检查 Node ≥ 18、脚本语法与余额。用 --explain 查看模型决策，用 --estimate 查看费用，再执行生成命令：node "$HOME/.claude/skills/generate-image/generate.mjs" "<prompt>" [flags] --json --out "<dir>/"。退出码 0 成功，2 参数或 API 400，3 缺 key，4 认证失败，5 余额不足，6 限流，7 生成失败，8 轮询超时，9 文件被审核拦截，10 确认时中止。
适用场景：需要按提示词批量或单张生成配图、封面、图标、插画等，并希望记录模型选择与费用明细的流程。
限制：提示词需为英文，最长 2000 字符；不得包含真实人物、第三方 logo、虚构证书或数字。每次付费调用前会显示费用块；重试或重新生成会再次计费，最多重试两次。余额不足时停止且不重试。.cache/ 不应手动编辑。部分端点（如余额查询）可能返回 404，实际费用来自 apiCreditCost。CDN 链接不过期，但 R2 上传路径暂未提供。