Stability AI 影像生成

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 自動配置、starter 模組的 artifact 名稱發生了重大變化。有關更多資訊，請參閱升級說明。

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

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

擴散過程對 prompt 文字的嚴格程度。範圍：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() 建立。