OpenAI API 연동 - STEP1) 연동하기 기초

OpenAI API를 Java 프로젝트에 연동하는 과정은 생각보다 간단합니다. 공식 라이브러리(Java용)가 존재하며, HTTP 통신을 통해서도 직접 구현할 수 있습니다. 여기서는 가장 기초적인 HTTP 클라이언트를 이용한 연동 방식을 기준으로 STEP 1을 상세히 설명해 드릴게요.

---

STEP 1: OpenAI API 연동 준비 및 기초 구현

1. 사전 준비물

• API Key 발급: OpenAI 플랫폼에 가입 후 API Keys 메뉴에서 키를 생성하세요. (키는 한 번만 보여지니 꼭 복사해두세요!)
• 의존성 추가 (Maven/Gradle): JSON 데이터를 처리하기 위해 Jackson 또는 Gson 라이브러리를 사용하면 편리합니다.

Maven (pom.xml) 기준:

XML

 

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.15.2</version>
</dependency>

---

2. Java 예제 코드 (Standard HTTP Client)

Java 11 이상에서 제공하는 HttpClient를 사용하여 별도의 복잡한 라이브러리 설치 없이 API를 호출하는 코드입니다.

Java

 

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class OpenAIExample {
    // ⚠️ 주의: 실제 환경에서는 API 키를 환경변수나 설정 파일에 저장하세요.
    private static final String API_KEY = "YOUR_OPENAI_API_KEY_HERE";
    private static final String API_URL = "https://api.openai.com/v1/chat/completions";

    public static void main(String[] args) {
        try {
            // 1. 요청 본문(JSON) 작성
            // gpt-3.5-turbo 또는 gpt-4o 모델을 주로 사용합니다.
            String jsonPayload = """
                {
                    "model": "gpt-3.5-turbo",
                    "messages": [
                        {"role": "system", "content": "너는 친절한 어시스턴트야."},
                        {"role": "user", "content": "Java에서 API를 호출하는 방법을 알려줘."}
                    ],
                    "temperature": 0.7
                }
                """;

            // 2. HTTP 클라이언트 및 요청 설정
            HttpClient client = HttpClient.newHttpClient();
            HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(API_URL))
                .header("Content-Type", "application/json")
                .header("Authorization", "Bearer " + API_KEY) // 인증 헤더
                .POST(HttpRequest.BodyPublishers.ofString(jsonPayload))
                .build();

            // 3. API 호출 및 응답 수신
            System.out.println("OpenAI에 질문을 던지는 중...");
            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

            // 4. 결과 출력
            if (response.statusCode() == 200) {
                System.out.println("--- 응답 결과 ---");
                System.out.println(response.body());
            } else {
                System.out.println("에러 발생! 상태 코드: " + response.statusCode());
                System.out.println(response.body());
            }

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

---

3. 코드 상세 분석

• API URL: [https://api.openai.com/v1/chat/completions](https://api.openai.com/v1/chat/completions)는 대화형 모델(ChatGPT)을 호출하는 엔드포인트입니다.
• Authorization 헤더: Bearer {API_KEY} 형식을 정확히 지켜야 합니다. 이 헤더가 없으면 401 에러가 발생합니다.
• JSON 구조:
  • model: 사용할 AI 모델의 이름입니다.
  • messages: 대화의 맥락입니다. system은 AI의 역할을 정의하고, user는 실제 질문을 담습니다.
  • temperature: 답변의 창의성 조절(0에 가까울수록 일관되고, 2에 가까울수록 창의적임).

---

4. 다음 단계로 넘어가기 위한 체크리스트

1. 응답 파싱: 위 코드의 response.body()는 JSON 문자열입니다. 이를 Jackson 라이브러리를 사용해 choices[0].message.content 값만 추출하는 로직을 추가해 보세요.
2. 환경 변수 관리: 보안을 위해 System.getenv("OPENAI_API_KEY")와 같은 방식을 사용하세요.
3. 예외 처리: 네트워크 타임아웃이나 할당량 초과(429 에러)에 대한 처리를 추가하면 더욱 견고한 프로그램이 됩니다.

 

2026.05.08 - [AI] - OpenAI API 연동 - STEP2) 데이터 처리