[AI] OpenAI API를 사용하기 위한 기초 가이드 (노코딩 테스트 포함)

OpenAI API란?

이제는 생성형 인공 지능 서비스인 ChatGPT를 모르시는 분들이 거의 없을 텐데요. OpenAI의 ChatGPT 사이트에서 채팅하는 방법 뿐만 아니라, OpenAI에서 제공하는 GPT 모델을 API로 호출하여 사용하는 방법도 있습니다. 이 방식은 무료는 아니지만 직접 모델을 구축하는 것에 비해 훨씬 효율적입니다.

참고로, OpenAI API는 유료 서비스인 ChatGPT Plus 구독과는 다른 것입니다. GPT Plus는 월 결제 방식으로, 새로운 GPT 모델과 빠른 응답속도, 더 긴 대화를 할 수 있는 장점이 있는데요. API는 말 그대로 프로그래밍을 통해 메시지를 서버로 보내면 응답을 받는 형태로, 다양한 애플리케이션 구현이 가능해집니다.

OpenAI API에서 제공하는 기능

API는 다양한 기능을 제공하며, 개발자가 알맞은 기능을 선택하여 다양한 애플리케이션 구현이 가능합니다. 간단하게 정리하면 다음과 같습니다.

• Text Generation(텍스트 생성): 사용자의 질문에 자연스러운 답변을 생성하는 기능으로, 일반적으로 사용하는 ChatGPT의 채팅 기능.
• Image Generation(이미지 생성): 사용자의 프롬프트에 따라 이미지를 생성하는 기능.
• Vision: 사용자의 이미지를 이해하고 분석하는 기능.
• Vector Embbeddings: 사용자의 데이터를 벡터 공간으로 변환하여 수치화하고, 수치의 유사성으로 결과를 활용하는 기능.
• TTS(Text To Speech): 텍스트를 음성으로 변환하는 기능.
• STT(Speech To Text): 음성을 텍스트로 변환하는 기능.
• Moderation: 텍스트에 유해하거나 부적절한 내용이 있는지 판단하는 기능.
• Reasoning: 복잡한 문제에 대해 더 정확하고 깊이있는 대답을 생성하는 기능.

서론이 많이 길었습니다. 이제 본문에서는 Text Generation을 기준으로 API 준비 과정과 노코딩 테스트 방법 소개하겠습니다.

따라하기

1. API Key 발급 받기

아래 사이트에 접속하여 회원가입 및 로그인을 합니다.

https://platform.openai.com/

그리고 Settings > API Keys 또는 Dashboard > API Keys 메뉴를 눌러 API Keys 페이지로 이동합니다.

API Keys 화면

우측 상단의 Create new secret key 버튼을 클릭하면 아래의 화면이 표시됩니다. 이름과 프로젝트, 권한을 지정하고 생성 버튼을 클릭합니다. '프로젝트'는 애플리케이션마다 생성하여 API 키를 관리할 때 지정하면 되겠습니다. 일단 테스트를 위해 Default를 선택하세요. 이름과 권한은 나중에라도 변경할 수 있습니다.

Key 생성 화면

키가 생성되면 아래와 같이 표시됩니다. 참고로, 키는 한 번 생성되면 다시 확인할 수 없으니 관리할 수 있는 곳에 적어 놓길 권장합니다.

키가 생성된 화면

2. 크레딧 및 결제 정보 추가하기

참고로, 최초에 가입하면 무료 크레딧을 일정 금액 제공했었습니다(지금은 모르겠네요). 앞으로 API를 호출하면 크레딧이 소진하게 됩니다. 당연하지만, 크레딧이 없으면 API 호출은 불가능합니다.

청구 페이지

결제 정보를 입력하기 위해 Billing > Payment methods 메뉴를 클릭합니다. 그리고 카드 정보를 입력하고 추가 버튼을 클릭하면 쉽게 완료할 수 있습니다.

결제 정보 입력 화면

저는 처음 테스트를 위해 $5를 결제했는데요. 호출 토큰 양이 많지 않은 이상, API 테스트를 하기에는 충분하다고 생각합니다.

결제 후 화면

만약, 크레딧이 모자르면 Add to credit balance 버튼을 클릭해 충전하시면 됩니다.

크레딧 충전 화면

3. Talend API Tester에서 간단하게 테스트하기

크롬 확장 프로그램인 Talend API Tester에서 간단하게 API 테스트를 할 수 있습니다.

API 요청 화면

POST 메소드를 선택하고, API 요청 주소는 https://api.openai.com/v1/chat/completions 을 입력합니다. 그리고 헤더에는 아래의 정보를 입력합니다.

항목	값
Content-Type	application/json
Authorization	Bearer [API Key]
OpenAI-Beta	assistants=v2

그리고 BODY에는 아래의 정보를 예시로 입력합니다. 모델과 메시지는 자유롭게 선택해도 좋습니다.

{
  "model": "gpt-3.5-turbo",
  "messages": [
    {"role": "user", "content": "Hello, how are you?"}
  ]
}

Send 버튼을 클릭하면, 아래와 같은 응답을 받게 됩니다. BODY의 content에 응답한 메시지가 포함되어 있습니다.

응답 화면

이제 Dashboard > Usage 메뉴에 들어가 보면, 방금 호출한 API에 얼마의 크레딧이 소진되었는지 확인할 수 있습니다.

크레딧 사용량 화면

참고로, 선택한 모델과 토큰 양에 따른 금액은 아래 페이지에 안내되어 있습니다.

https://platform.openai.com/docs/pricing

모델 가격 표