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 自動配置、啟動模組的工件名稱發生了重大變化。請參閱 升級說明 以獲取更多資訊。

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() 建立。
© . This site is unofficial and not affiliated with VMware.