Spring AI 支持 Stability AI 的[文本到图像生成模型](https://platform.stability.ai/docs/api-reference#tag/v1generation)。
先决条件
你需要创建一个与Stability AI的API密钥以访问他们的AI模型，遵循他们的[入门文档](https://platform.stability.ai/docs/getting-started/authentication)。
Spring AI项目定义了一个名为`spring.ai.stabilityai.api-key`的配置属性，你应该将其设置为从Stability AI获取的`API Key`的值。导出一个环境变量是设置该配置属性的一种方式。
export SPRING_AI_STABILITYAI_API_KEY=<INSERT KEY HERE>自动配置
Spring AI为Stability AI图像生成客户端提供了Spring Boot自动配置。要启用它，请将以下依赖项添加到您项目的Maven pom.xml 文件中：
<dependency>
<groupId>org.springframework.ai</groupId>
<artifactId>spring-ai-stability-ai-spring-boot-starter</artifactId>
</dependency>或者添加到你的Gradle build.gradle 构建文件中。
dependencies {
implementation 'org.springframework.ai:spring-ai-stability-ai-spring-boot-starter'
}|
Tip
|
参考依赖管理部分，以将Spring AI BOM添加到您的构建文件中。 |
图像生成属性
前缀`spring.ai.stabilityai`被用作属性前缀，它让你能够连接到Stability AI。
| 属性 | 描述 | 默认值 |
|---|---|---|
spring.ai.stabilityai.base-url |
连接的URL地址 |
|
spring.ai.stabilityai.api-key |
API密钥 |
- |
前缀 spring.ai.stabilityai.image 是一个属性前缀，它允许你为 Stability AI 配置 ImageClient 的实现。
| 属性 | 描述 | 默认值 |
|---|---|---|
spring.ai.stabilityai.image.enabled |
启用 Stability AI 图像客户端。 |
|
true |
spring.ai.stabilityai.image.base-url |
|
可选覆盖 spring.ai.openai.base-url 以提供特定的 url |
||
spring.ai.stabilityai.image.api-key |
可选覆盖 spring.ai.openai.api-key 以提供特定的 api-key |
- |
spring.ai.stabilityai.image.option.n |
生成图像的数量。必须在1到10之间。 |
|
1 |
spring.ai.stabilityai.image.option.model |
|
在 Stability AI 中使用的引擎/模型。模型作为路径参数传递在 URL 中。 |
|
|
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 |
传入一种风格预设以引导图像模型朝特定风格发展。这个风格预设列表可能会变化。 |
|
|
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 |
|
传入一种风格预设以引导图像模型朝特定风格发展。这个风格预设列表可能会变化。 |
- |
运行时选项
The StabilityAiImageOptions.java 文件提供了模型配置，例如要使用的模型、样式、大小等。
在启动时，可以通过`StabilityAiImageClient(StabilityAiApi stabilityAiApi, StabilityAiImageOptions options)`构造函数配置默认选项。或者，使用之前描述的`spring.ai.openai.image.options.*`属性。
在运行时，你可以通过向`ImagePrompt`调用添加新的、特定于请求的选项来覆盖默认选项。例如，要覆盖Stability AI特定的选项，如质量和要创建的图片数量，使用以下代码示例：
ImageResponse response = openaiImageClient.call(
new ImagePrompt("A light cream colored mini golden doodle",
StabilityAiImageOptions.builder()
.withStylePreset("cinematic")
.withN(4)
.withHeight(1024)
.withWidth(1024).build())
''');