Stability AI 图像生成技能用于通过 Stability AI API 生成艺术化与照片级写实图像，支持 SD3.5、Ultra、Core 等模型。采用 Community License，个人及小型企业使用无限制。
一、用途与适用场景 该技能适合数字艺术、插画、概念艺术、电影级写实（8K、细节丰富）、海报、壁纸、书籍封面、游戏素材等场景，也支持局部重绘、放大分辨率、去除背景、搜索替换、擦除图像元素等编辑操作。当用户提到 stability ai、stable diffusion、sd3.5、生成艺术、生成插画、image to image 等主题时可使用。若任务与 Stability AI 无关、有更简单专用的工具可处理，或用户需要无领域专长的通用协助，则不应使用本技能。
二、主要能力（操作模式）
- --mode generate：文生图（SD3.5），端点 /generate/sd3
- --mode ultra：文生图高级版，端点 /generate/ultra
- --mode core：文生图快速版，端点 /generate/core
- --mode img2img：图像加文本生成新图，端点 /generate/sd3
- --mode upscale：保守放大分辨率，端点 /upscale/conservative
- --mode upscale-creative：带细节的放大，端点 /upscale/creative
- --mode remove-bg：去除背景（输出透明 PNG），端点 /edit/remove-background
- --mode inpaint：基于蒙版编辑图像局部，端点 /edit/inpaint
- --mode search-replace：按描述替换图像中的对象，端点 /edit/search-and-replace
- --mode erase：擦除图像局部，端点 /edit/erase
三、使用方式
- 在 platform.stability.ai 创建账户（免费），从仪表盘复制 API Key。
- 在 .env 中填入：STABILITY_API_KEY=sk-你的密钥
- 安装依赖：pip install -r scripts/requirements.txt
- 通过命令行脚本调用，例如： python scripts/generate.py --prompt "a serene mountain landscape at sunset" --mode generate python scripts/generate.py --prompt "cinematic portrait, dramatic lighting" --mode ultra --aspect-ratio 16:9 python scripts/generate.py --prompt "cute cat ninja" --mode core --style anime python scripts/generate.py --prompt "watercolor style" --mode img2img --image foto.jpg --strength 0.7 python scripts/generate.py --mode remove-bg --image produto.jpg python scripts/generate.py --prompt "red roses" --mode inpaint --image jardim.jpg --mask mascara.png python scripts/generate.py --prompt "a golden retriever" --mode search-replace --image parque.jpg --search "the cat" python scripts/generate.py --mode erase --image foto.jpg --mask area.png python scripts/generate.py --list-models python scripts/generate.py --list-styles python scripts/generate.py --prompt "anime warrior girl, widescreen" --analyze --json
四、宽高比 支持 square（1:1）、portrait（2:3）、landscape（3:2）、photo（4:5）、wide（16:9）、ultrawide（21:9）、stories（9:16）、phone（9:21），并带有 ig、instagram、pinterest、youtube、tiktok 等别名。
五、风格预设（15 种） 每种风格会自动向提示词添加限定词：photorealistic、anime、digital-art、oil-painting、watercolor、pixel-art、3d-render、concept-art、comic、minimalist、fantasy、sci-fi、sketch、pop-art、noir。
六、输出 图片保存至 data/outputs/，命名格式为 {mode}{style}{timestamp}_{index}.png；元数据保存为 .meta.json，包含原始提示词、最终提示词、模型、宽高比、seed、耗时、大小。
七、与其他技能集成 可与 ai-studio-image（Stability AI 负责艺术、Gemini 负责人像照片）、instagram（生成艺术后发布）、telegram（生成图片后通过机器人发送）配合使用。
八、速率限制与安全 Community License 为 150 请求/10 秒；每日上限 100 张图片（可通过 SAFETY_MAX_IMAGES_PER_DAY 配置）；遇到 429 时自动指数退避重试；支持 API Key 回退（主密钥加备份）。
九、参考文件 references/setup-guide.md（初始设置、API Key、故障排查）、references/prompt-engineering.md（高级提示词技巧）、references/api-reference.md（端点、参数、响应、错误）。
十、限制 仅在任务明确匹配上述范围时使用；输出不应替代针对具体环境的验证、测试或专家审查；若缺少必要输入、权限、安全边界或成功标准，应停止并请求澄清。