name: stability-ai description: 通过Stability AI API（SDXL、SD3、Stable Image Core）生成高质量图像。当用户要求“生成图像”、“制作图片”或“绘制这个”时使用。

Stability AI 技能

设置

将 .env.example 复制为 .env。
在 .env 中设置 STABILITY_API_KEY。
可选：如果使用自定义端点，请设置 API_HOST。

使用方法

角色：数字艺术家。
触发词：“画一只猫”、“生成赛博朋克城市”、“创建一张图片”。
输出：生成的图像的本地文件路径和JSON元数据。

命令

（脚本在首次运行时自动处理依赖项）

# 基本生成
scripts/generate "一座霓虹闪烁的未来城市"

# 宽高比 (1:1, 16:9, 9:16, 21:9, 4:3, 3:4)
scripts/generate "风景画" --ratio 16:9

# 风格预设
scripts/generate "战士肖像" --style photographic

# 种子值用于可复现性
scripts/generate "抽象艺术" --seed 42

# 负面提示词
scripts/generate "美丽的日落" --negative "模糊，低质量"

# 输出格式 (png, jpg, webp)
scripts/generate "自然场景" --format webp

# 高级：自定义模型、步数、CFG 缩放
scripts/generate "奇幻风景" \
  --model stable-diffusion-3-medium \
  --steps 50 \
  --cfg 7.0 \
  --ratio 21:9

# V2 API（实验性）
scripts/generate "现代建筑" --v2

# 组合选项
scripts/generate "夜晚的赛博朋克街道" \
  --ratio 16:9 \
  --style neon-punk \
  --seed 123 \
  --format jpg \
  --steps 45 \
  --cfg 6.5

功能

风格预设

可用风格：增强、动漫、摄影、数字艺术、漫画书、奇幻艺术、线条艺术、模拟胶片、霓虹朋克、等距、低多边形、折纸、建模粘土、电影感、3D模型、像素艺术、瓷砖纹理

宽高比

支持：1:1（默认）、16:9、9:16、21:9、4:3、3:4

输出格式

PNG（默认，无损）
JPEG/JPG（有损，文件更小）
WebP（现代，高效）

元数据

每个生成的图像都包含一个JSON元数据文件，其中包含：

提示词和负面提示词
模型、参数和设置
生成时间戳
使用的API版本

模型

默认：SDXL 1.0 (stable-diffusion-xl-1024-v1-0)
完整模型列表、API版本和积分消耗，请参见 references/models.md。

自动清理

自动保留最近生成的20张图像。较旧的文件及其元数据将被删除以节省磁盘空间。