Stability AI 图像生成
Spring AI 支持 Stability AI 的 文生图模型。
先决条件
您需要创建一个 Stability AI API 密钥来访问其 AI 模型。请按照他们的快速入门文档获取您的 API 密钥。
Spring AI项目定义了一个配置属性 spring.ai.stabilityai.api-key，您应将其设置为从Stability AI获取的API Key的值。
你可以在 application.properties 文件中设置此配置属性：
spring.ai.stabilityai.api-key=<your-stabilityai-api-key>
为了增强处理敏感信息（如API密钥）时的安全性，您可以使用Spring表达式语言（SpEL）来引用自定义环境变量：
# In application.yml
spring:
ai:
stabilityai:
api-key: ${STABILITYAI_API_KEY}
# In your environment or .env file
export STABILITYAI_API_KEY=<your-stabilityai-api-key>
你也可以在应用程序代码中以编程方式设置此配置：
// Retrieve API key from a secure source or environment variable
String apiKey = System.getenv("STABILITYAI_API_KEY");
自动配置
Spring AI 自动配置和 starter 模块的构件名称发生了重大变化。详细信息请参考升级说明。
Spring AI 为 Stability AI 图像生成客户端提供了 Spring Boot 自动配置。要启用此功能，请将以下依赖项添加到您项目的 Maven pom.xml 文件中：
<dependency>
<groupId>org.springframework.ai</groupId>
<artifactId>spring-ai-starter-model-stability-ai</artifactId>
</dependency>
或将其添加到您的Gradle build.gradle 构建文件中。
dependencies {
implementation 'org.springframework.ai:spring-ai-starter-model-stability-ai'
}
:::提示
请参考依赖管理章节，将 Spring AI BOM 添加到您的构建文件中。
:::
图像生成属性
前缀 spring.ai.stabilityai 用作属性前缀，允许您连接到 Stability AI。
| 属性 | 说明 | 默认值 |
|---|---|---|
| spring.ai.stabilityai.base-url | 连接到的 URL | api.stability.ai/v1 |
| spring.ai.stabilityai.api-key | API 密钥 | - |
图像自动配置的启用与禁用现在通过以 spring.ai.model.image 为前缀的顶级属性进行配置。
启用方式：spring.ai.model.image=stabilityai （默认已启用）
禁用方式：spring.ai.model.image=none （或任何不匹配 stabilityai 的值）
此项变更是为了支持多模型配置。
前缀 spring.ai.stabilityai.image 是用于配置 Stability AI 的 ImageModel 实现的属性前缀。
| 属性 | 描述 | 默认值 |
|---|---|---|
| spring.ai.stabilityai.image.enabled (已移除且不再有效) | 启用 Stability AI 图像模型。 | true |
| spring.ai.model.image | 启用 Stability AI 图像模型。 | stabilityai |
| spring.ai.stabilityai.image.base-url | 可选，用于覆盖 spring.ai.openai.base-url 以提供特定的 URL | https://api.stability.ai/v1 |
| spring.ai.stabilityai.image.api-key | 可选，用于覆盖 spring.ai.openai.api-key 以提供特定的 API 密钥 | - |
| spring.ai.stabilityai.image.option.n | 要生成的图像数量。必须在 1 到 10 之间。 | 1 |
| spring.ai.stabilityai.image.option.model | Stability AI 中使用的引擎/模型。模型作为路径参数在 URL 中传递。 | stable-diffusion-v1-6 |
| spring.ai.stabilityai.image.option.width | 要生成的图像的宽度，以像素为单位，增量必须能被 64 整除。应用引擎特定的尺寸验证。 | 512 |
| spring.ai.stabilityai.image.option.height | 要生成的图像的高度，以像素为单位，增量必须能被 64 整除。应用引擎特定的尺寸验证。 | 512 |
| spring.ai.stabilityai.image.option.responseFormat | 生成的图像的返回格式。必须是 "application/json" 或 "image/png"。 | - |
| spring.ai.stabilityai.image.option.cfg_scale | 扩散过程遵循提示文本的严格程度。范围：0 到 35。 | 7 |
| spring.ai.stabilityai.image.option.clip_guidance_preset | 传入样式预设以引导图像模型趋向于特定样式。此样式预设列表可能会更改。 | NONE |
| spring.ai.stabilityai.image.option.sampler | 用于扩散过程的采样器。如果省略此值，将自动选择合适的采样器。 | - |
| spring.ai.stabilityai.image.option.seed | 随机噪声种子（省略此选项或使用 0 表示随机种子）。有效范围：0 到 4294967295。 | 0 |
| spring.ai.stabilityai.image.option.steps | 要运行的扩散步数。有效范围：10 到 50。 | 30 |
| spring.ai.stabilityai.image.option.style_preset | 传入样式预设以引导图像模型趋向于特定样式。此样式预设列表可能会更改。 | - |
运行时选项
StabilityAiImageOptions.java 提供了模型配置选项，例如使用的模型、风格、尺寸等。
在启动时，可以通过 StabilityAiImageModel(StabilityAiApi stabilityAiApi, StabilityAiImageOptions options) 构造函数配置默认选项。或者，使用之前描述的 spring.ai.openai.image.options.* 属性进行配置。
在运行时，你可以通过在 ImagePrompt 调用中添加新的、特定于请求的选项来覆盖默认选项。例如，要覆盖 Stability AI 特定的选项，比如质量和要创建的图像数量，请使用以下代码示例：
ImageResponse response = stabilityaiImageModel.call(
new ImagePrompt("A light cream colored mini golden doodle",
StabilityAiImageOptions.builder()
.stylePreset("cinematic")
.N(4)
.height(1024)
.width(1024).build())
);
:::提示
除了特定于模型的 StabilityAiImageOptions，你也可以使用一个可移植的 ImageOptions 实例，该实例通过 ImageOptionsBuilder#builder() 创建。
:::