Stability AI 이미지 생성

Stability AI 이미지 생성 (Stability AI Image Generation)

Spring AI는 Stability AI의 텍스트-이미지 생성 모델을 지원해요. 이 글에서는 API 키 설정, 자동 설정, 이미지 관련 프로퍼티, 그리고 런타임 옵션까지 알아볼게요.

출처: 문서

본문

Spring AI는 Stability AI의 text to image generation model을 지원해요.

Prerequisites

Stability AI의 AI 모델에 접근하려면 Stability AI로 API 키를 만들어야 해요. API 키를 얻으려면 그들의 Getting Started documentation을 따라가세요.

Spring AI 프로젝트는 spring.ai.stabilityai.api-key라는 구성 프로퍼티를 정의하는데, 여기에 Stability AI에서 얻은 API Key 값을 설정해야 해요.

이 구성 프로퍼티를 application.properties 파일에 설정할 수 있어요:

spring.ai.stabilityai.api-key=<your-stabilityai-api-key>

API 키 같은 민감한 정보를 다룰 때 보안을 강화하려면, Spring Expression Language(SpEL)를 사용해 커스텀 환경 변수를 참조할 수 있어요:

# In application.yml
spring:
  ai:
    stabilityai:
      api-key: ${STAB...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");

Auto-configuration

Spring AI는 Stability AI Image Generation Client에 대한 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'
}

Image Generation Properties

프리픽스 spring.ai.stabilityai는 Stability AI에 연결할 수 있게 해주는 프로퍼티 프리픽스예요.

프리픽스 spring.ai.stabilityai.image는 Stability AI의 ImageModel 구현을 구성할 수 있게 해주는 프로퍼티 프리픽스예요.

Runtime Options

StabilityAiImageOptions.java는 사용할 모델, 스타일, 크기 등 모델 구성을 제공해요.

시작 시 기본 옵션은 StabilityAiImageModel(StabilityAiApi stabilityAiApi, StabilityAiImageOptions options) 생성자로 구성할 수 있어요. 또는 앞서 설명한 spring.ai.stabilityai.image.* 프로퍼티를 사용할 수도 있어요.

런타임에는 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())

);

더 알아보기 (Learn more)