Stability AI Image Generation
Spring AI 支持 Stability AI 的 text to image generation model。
Prerequisites
您需要使用 Stability AI 的 API 密钥来访问其 AI 模型，请关注他们的 Getting Started documentation。
Spring AI 项目定义了一个名为 spring.ai.stabilityai.api-key 的配置属性，你应将其设置为从 Stability AI 获得的 API Key 的值。导出环境变量是一种设置该配置属性的方法。
export SPRING_AI_STABILITYAI_API_KEY=<INSERT KEY HERE>Auto-configuration
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'
}
|
Image Generation Properties
前缀 spring.ai.stabilityai 用作允许你连接到 Stability AI 的属性前缀。
| Property | Description | Default |
|---|---|---|
spring.ai.stabilityai.base-url |
连接到的 URL |
[role="bare"]https://api.stability.ai/v1 |
spring.ai.stabilityai.api-key |
The API Key |
- |
前缀 spring.ai.stabilityai.image 是允许你配置适用于 Stability AI 的 ImageClient 实现的属性前缀。
| Property | Description | Default |
|---|---|---|
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 密钥 |
- |
spring.ai.stabilityai.image.option.n |
要生成的图像数。必须在 1 到 10 之间。 |
1 |
spring.ai.stabilityai.image.option.model |
Stability AI 中要使用的引擎/模型。模型作为 URL 中的一个 path 参数进行传递。 |
|
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 |
传入一个风格预设，以引导图像模型采用特定的风格。此风格预设列表可能会发生更改。 |
- |
Image Options
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())
);
|