stability-ai - setup-guide

设置指南 — Stable Diffusion 技能

1. 在 Stability AI 创建账户

1. 访问https://platform.stability.ai
2. 点击Sign Up（如果已有账户则点击 Login）
3. 可以使用 Google、GitHub 或邮箱/密码
4. Community License对个人使用或年收入 < $1M 的企业是免费且自动的

2. 获取 API Key

1. 登录后，前往Account>API Keys（或直接访问：https://platform.stability.ai/account/keys）
2. 点击Create API Key
3. 起个名字（例如 “claude-skills”）
4. 复制生成的 key（以sk-开头）

3. 配置 Key

编辑技能根目录下的.env文件（stable-diffusion/.env）：

STABILITY_API_KEY=sk-sua-chave-aqui

替代方案：导出为环境变量：

exportSTABILITY_API_KEY="sk-sua-chave-aqui"

4. 安装依赖

cdstable-diffusion pipinstall-rscripts/requirements.txt

唯一的外部依赖：Pillow（图像处理）。
HTTP 调用使用urllib（Python 标准库）。

5. 测试连接

python scripts/generate.py --list-models

如果 key 正确，你将看到可用模型列表。

6. 首次生成

python scripts/generate.py--prompt"a beautiful sunset over mountains"--modegenerate

图像将保存在data/outputs/。

故障排查

错误 401（未授权）

• 检查.env中的 key 是否正确
• 检查 key 中是否有多余空格
• 在仪表盘生成新 key

错误 402（需要付款）

• 你的账户可能已超出信用额度
• Community License 使用量宽裕，但在高峰期可能有限制
• 检查仪表盘了解状态

错误 429（请求过多）

• 限制：每 10 秒 150 个请求
• 脚本已自动重试并带退避
• 如果持续，等待几分钟

错误 400（错误请求）

• 检查提示词是否为空
• 检查宽高比是否有效（使用--list-models查看选项）
• 对于 img2img/inpaint，检查图像文件是否存在

图像未保存

• 检查data/outputs/的写入权限
• 该目录会自动创建，但在受限环境中可能失败

详细速率限制

安全

• key 永远不会被记录或显示在输出中
• .env在.gitignore中（不要提交！）
• 可配置每日限制：SAFETY_MAX_IMAGES_PER_DAY=100（环境变量）
• 每日计数器在data/daily_counter.json