stability-sdk

几行代码调用 Stable Diffusion，快速集成图像生成能力。

stability-sdk 是 Stability AI 官方提供的 Python SDK，用于与 stability.ai 的 API 交互，核心是调用 Stable Diffusion 模型进行文本到图像的生成。它解决了开发者直接调用 REST API 时需处理认证、请求构造、响应解析等繁琐流程的问题，封装了文本生成图像、图像到图像、图像修复等核心能力，并支持异步调用和多种参数配置。SDK 基于 Jupyter Notebook 示例，提供了直观的上手体验，适合快速集成到现有应用中。

开源 pay_as_you_go 图像生成

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2434

维护状态低维护

是否开源是

定价模式 pay_as_you_go

项目数据

分类图像生成

开发团队Stability-AI

所属国家

官网地址https://platform.stability.ai

GitHubhttps://github.com/Stability-AI/stability-sdk

定价模式pay_as_you_go

价格说明Stability AI 平台提供 API 服务，按调用量或 token 计费，具体价格需查看官网定价页。

访问状态

是否开源是

开源协议MIT

主要语言Jupyter Notebook

技术栈/模型ai-art,generative-art,latent-diffusion,multimodal,stable-diffusion

GitHub 星标★ 2434

30天Star增速

HF 下载量

上线时间2022-08-22 00:00:00

最近更新2026-09-21 00:00:00

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

难度：入门约 10 分钟部署方式：库/依赖 7 步

环境要求

Python 3 环境（需可运行 python3 -m 模块）
已安装 pip，可执行 pip install
Stability AI 账号并获取 API Key（platform.stability.ai）
可访问网络与 grpc.stability.ai:443 通信

安装与启动步骤

1获取 API Key

按 Platform 官方认证文档的指引注册并获取 API Key，后续调用必须用到，注意妥善保管。
2安装 SDK

从 PyPI 安装官方 stability-sdk 包，安装后即可使用命令行客户端和 Python API。
```
pip install stability-sdk
```
3设置环境变量

STABILITY_KEY 填你自己的密钥；STABILITY_HOST 默认已是 grpc.stability.ai:443，一般按默认值写即可。
```
export STABILITY_HOST=grpc.stability.ai:443
export STABILITY_KEY=sk-xxxxxxxx
```
4生成第一张图

执行文本生成图像，默认 1024x1024，生成的 PNG 会写入当前目录。
```
python3 -m stability_sdk generate -W 1024 -H 1024 "A stunning house."
```
5放大图片

对已有图片做放大（upscale），通过 -i 指定本地图片的完整路径。
```
python3 -m stability_sdk upscale -i "/path/to/image.png"
```
6启动动画界面

需要动画 UI 时先装 anim_ui 附加依赖，再用 animate 命令启动图形界面。
```
pip install stability-sdk[anim_ui]
python3 -m stability_sdk animate --gui
```
7查看全部参数

用 -h 查看 generate 支持的高度、采样器、风格预设、种子、引擎等选项。
```
python3 -m stability_sdk generate -h
```

关键配置

配置项	必填	说明	示例
`STABILITY_KEY`	是	API 认证密钥，调用接口必须设置	`sk-xxxxxxxx`
`STABILITY_HOST`	否	gRPC 服务地址，默认为生产端点，通常无需改动	`grpc.stability.ai:443`

如何确认成功

命令执行完且无报错，当前目录出现生成的 PNG 图片文件即表示成功。

常见问题

Q：没有 API Key 可以运行吗？

A：不行。必须先在 platform.stability.ai 按认证文档获取 API Key，并设置为 STABILITY_KEY 环境变量后才能调用。

Q：生成的图片保存在哪里？

A：默认写入当前工作目录，格式为 PNG；可用 --prefix/-p 参数指定输出文件的前缀。

Q：怎么调整图片尺寸和采样器？

A：用 -H/--height、-W/--width 设置尺寸，-A/--sampler 指定采样器（如 ddim、k_euler、k_lms 等），-s 指定步数。

Q：upscale 时还需要写提示词吗？

A：upscale 的位置参数 prompt 在 esrgan 引擎下会被忽略，主要用 -i 指定待放大的初始图片。

Q：想不写文件、直接看图怎么办？

A：加 --no-store 可以不写出 artifact，加 --show 则会用 PIL 打开生成结果。

注意事项

STABILITY_HOST 默认就是 grpc.stability.ai:443，除非有特殊需求否则不必手动设置。
API Key 属于敏感信息，不要硬编码进代码或提交到 Git 仓库。
如需从源码以可编辑模式安装，README 给出的是在 venv 中执行 pyenv/bin/pip3 install -e .，需在项目仓库目录下进行。
更多 API 用法请查阅 platform.stability.ai 的完整文档。

核心亮点

官方维护，API 封装完整，涵盖文生图、图生图、修复等主流功能
提供 Jupyter Notebook 示例，上手门槛低，便于快速验证效果
支持异步调用，适合高并发场景，提升生成效率

不足之处

依赖 Stability AI 的商业 API，需付费获取密钥，无法本地运行
文档更新滞后，部分新功能示例缺失，社区反馈需自行摸索

适用场景

快速原型开发，验证 Stable Diffusion 在业务中的可行性
在应用中集成文生图功能，如设计辅助、内容创作工具
批量生成图像素材，用于营销、游戏或影视预制作

替代项目

diffusers、stable-diffusion-webui、InvokeAI

项目介绍

stability-sdk 是开发框架领域的开源项目，由 Stability-AI 开发，2022 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（2,434）位列前 30%，在开发框架分类中处于中上游。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-21。Stability AI 平台提供 API 服务，按调用量或 token 计费，具体价格需查看官网定价页。

它主要面向的使用场景是：快速原型开发，验证StableDiffusion在业务中的可行性。同类可对比的替代方案包括 diffusers、stable-diffusion-webui、InvokeAI。

上一篇：openai-async

下一篇：YiVal