OpenAI 이미지 생성

OpenAI 이미지 생성 (OpenAI Image Generation)

Spring AI는 OpenAI의 이미지 생성 모델인 DALL-E를 지원해요. 이 글에서는 API 키 설정, 자동 설정, 이미지 관련 프로퍼티, 런타임 옵션, 그리고 HTTP 클라이언트 커스터마이징까지 알아볼게요.

출처: 문서

본문

Spring AI는 OpenAI의 이미지 생성 모델인 DALL-E를 지원해요.

Prerequisites

ChatGPT 모델에 접근하려면 OpenAI로 API 키를 만들어야 해요.

OpenAI signup page에서 계정을 만들고 API Keys page에서 토큰을 생성하세요.

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

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

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

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

# In application.yml
spring:
  ai:
    openai:
      api-key: ***

# In your environment or .env file
export OPENAI_API_KEY=<your-openai-api-key>

또한 애플리케이션 코드에서 프로그래밍 방식으로 이 구성을 설정할 수도 있어요:

// Retrieve API key from a secure source or environment variable
String apiKey = System.getenv("OPENAI_API_KEY");

Auto-configuration

Spring AI는 OpenAI Image Generation Client에 대한 Spring Boot 자동 설정을 제공해요. 활성화하려면 프로젝트의 Maven pom.xml 파일에 다음 의존성을 추가하세요:

<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-starter-model-openai</artifactId>
</dependency>

또는 Gradle build.gradle 빌드 파일에 추가할 수도 있어요:

dependencies {
    implementation 'org.springframework.ai:spring-ai-starter-model-openai'
}

Image Generation Properties

Connection Properties

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

Retry Properties

프리픽스 spring.ai.retry는 OpenAI Image 클라이언트의 재시도 메커니즘을 구성할 수 있게 해주는 프로퍼티 프리픽스예요.

Configuration Properties

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

Runtime Options

OpenAiImageOptions.java는 사용할 모델, 품질, 크기 등 모델 구성을 제공해요.

시작 시 기본 옵션은 OpenAiImageOptions를 OpenAiImageModel 생성자에 전달해 구성할 수 있어요. 또는 앞서 설명한 spring.ai.openai.image.* 프로퍼티를 사용할 수도 있어요.

런타임에는 ImagePrompt 호출에 새 요청별 옵션을 추가해 기본 옵션을 재정의할 수 있어요. 예를 들어 quality와 생성할 이미지 수 같은 OpenAI 특정 옵션을 재정의하려면 다음 코드 예시를 사용하세요:

ImageResponse response = openaiImageModel.call(
        new ImagePrompt("A light cream colored mini golden doodle",
        OpenAiImageOptions.builder()
                .quality("hd")
                .n(4)
                .height(1024)
                .width(1024).build())

);

Customizing the HTTP Client

Spring AI는 내부적으로 공식 openai-java SDK를 사용하며, SpringAiOpenAiHttpClient.Builder가 만든 커스텀 OkHttp 클라이언트로 HTTP 전송을 구성해요. 기저 OkHttpClient가 생성되기 전에 하나 이상의 OpenAiHttpClientBuilderCustomizer 빈을 노출해서 그 빌더를 가로챌 수 있어요. 각 커스터마이저는 모든 OpenAI 모델(chat, embedding, image, audio, moderation)이 사용하는 동일한 빌더를 받으므로, 커스터마이징이 균일하게 적용돼요.

@FunctionalInterface
public interface OpenAiHttpClientBuilderCustomizer {
    void customize(SpringAiOpenAiHttpClient.Builder builder);
}

전형적인 사용 사례:

• OkHttp Interceptor 인스턴스 등록 (인증, 전파 헤더, 커스텀 로깅);

• 디스패처 ExecutorService 교체 (예: 비동기 I/O를 가상 스레드로 라우팅);

• 빌더가 노출하는 프록시, SSL, 호스트 이름 검증, 연결 풀 크기 구성.

커스터마이저가 여러 개 있으면 @Order / Ordered 순서로, Spring AI 기본값 이후에 적용되므로 사용자 코드가 우선해요.

OpenAi*Model.Builder를 통해 모델을 수동으로 연결할 때도 동일한 훅을 사용할 수 있어요:

var chatModel = OpenAiChatModel.builder()
    .options(OpenAiChatOptions.builder().model("gpt-4o").build())
    .httpClientBuilderCustomizer(myCustomizer)
    .build();

더 알아보기 (Learn more)