OpenAI를 Spring Boot에 통합하기 단계별 가이드

Table of Contents

OpenAI를 Spring Boot에 통합하기: 단계별 가이드

Spring Boot 애플리케이션에 OpenAI의 강력한 AI 기능을 추가하고 싶으신가요? 이 글에서는 Spring Boot 프로젝트에 OpenAI API를 통합하는 방법을 단계별로 안내해 드리겠습니다.

1. 프로젝트 설정

먼저 Spring Boot 프로젝트를 설정해야 합니다. Spring Initializr를 사용하거나 IDE를 통해 새 프로젝트를 생성하세요. 프로젝트에 다음 의존성을 추가합니다:

Spring Web
Spring AI OpenAI Starter

Maven의 경우 pom.xml에 다음을 추가합니다:

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

Gradle을 사용한다면 build.gradle에 다음을 추가하세요:

textdependencies {
    implementation 'org.springframework.ai:spring-ai-openai-spring-boot-starter'
}

2. API 키 설정

OpenAI API를 사용하려면 API 키가 필요합니다. OpenAI 웹사이트에서 API 키를 생성한 후, application.properties 파일에 다음과 같이 추가합니다:

textspring.ai.openai.api-key=your-api-key-here

보안을 위해 API 키를 환경 변수로 설정하는 것이 좋습니다1.

3. OpenAI 서비스 구현

이제 OpenAI 서비스를 구현할 차례입니다. 다음과 같이 서비스 클래스를 생성합니다:

java@Service
public class OpenAIService {

    @Autowired
    private OpenAiChatClient openAiChatClient;

    public String askOpenAI(String prompt) {
        ChatResponse response = openAiChatClient.call(prompt);
        return response.getResult().getOutput().getContent();
    }
}

이 서비스는 OpenAI API에 요청을 보내고 응답을 받아 처리합니다2.

4. 컨트롤러 생성

API 엔드포인트를 만들기 위해 컨트롤러를 생성합니다:

java@RestController
@RequestMapping("/api/chat")
public class ChatController {

    @Autowired
    private OpenAIService openAIService;

    @PostMapping
    public ResponseEntity<String> chat(@RequestBody String message) {
        String response = openAIService.askOpenAI(message);
        return ResponseEntity.ok(response);
    }
}

이 컨트롤러는 클라이언트로부터 메시지를 받아 OpenAI 서비스에 전달하고, 결과를 반환합니다3.

5. 테스트 및 실행

애플리케이션을 실행하고 API를 테스트해보세요. Postman이나 curl을 사용하여 POST 요청을 보낼 수 있습니다:

bashcurl -X POST -H "Content-Type: text/plain" -d "Hello, ChatGPT!" http://localhost:8080/api/chat

응답으로 AI가 생성한 텍스트를 받게 될 것입니다.

이렇게 하면 Spring Boot 애플리케이션에 OpenAI API를 성공적으로 통합할 수 있습니다. 이를 통해 챗봇, 텍스트 생성, 질문 답변 시스템 등 다양한 AI 기반 기능을 구현할 수 있습니다.