Stability

Stability AI Image Generation

Spring AI 支持 Stability AI 的 文本到图像生成模型。

先决条件

您需要使用 Stability AI 创建 API 密钥才能访问其 AI 模型，请遵循其入门文档。

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'
}

配置属性

连接属性

spring.ai.stabilityai 前缀的属性，可让您配置 Stability AI 的连接。

图像生成属性

spring.ai.stabilityai.image 前缀的属性，可让您配置 Stability AI 的 ImageClient 实现。

Image 选项

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())

);

注意：除了特定于模型的 StabilityAiImageOptions 之外，您还可以使用 ImageOptionsBuilder#builder() 创建的可移植ImageOptions 实例。