OpenAI API Postman 활용 방법

OpenAI 에서 계속해서 버전 업된 모델을 출시

Microsoft 사에서는 MS 제품에 하나둘씩 gpt 를 비지니스에 추가

조만간 대화형 AI 가 주요 서비스에는 필수로 사용이 될 것 같다.

​

개발진영에서도 VSCode 확장팩, API 를 이용한 소스 리뷰, 리팩토링 등 다양하게 창의적로

사용하고 있다.

​

OpenAI 사이트 메뉴얼에서는 nodeJS, Python (flask) 샘플들이 있지만

API를 조금이라도 해본신 분들은 curl 하나만 봐도 이해할 수 있다.

​

간단한 테스트 용으로는 Postman 을 활용해 보는게 좋다.

PC에 nodeJS 패키지 설치, Python venv, flask 등 확인 작업만을 위해서는 번거롭다.

​

일단 openAI 사이트에 회원가입 -> 로그인을 해야 한다.

​

로그인을 하고 나면 오른쪽 상단에 Personal -> View API keys 클릭

회원가입을 하게 되면 Free trial usage 으로 사용할 수 있다.

(3개월 $18.00)

​

API Key 는 언제든지 삭제하고 생성할 수 있지만 생성할 때 저장하지 않으면 다시 찾을 수 없다.

위에서 생성한 키는 openai.api_key 로 사용되기 때문에 일단 어딘가 저장해 놓자!

(녹색 버튼 클릭하면 복사되니까 활용)

​

이제 Postman 오픈 .

이번에 사용하는 Postman 버전은 10.12.4 (Mac)

Postman 이 열리면 일단 workspace 를 생성해준다.

처음 접속하면 아무것도 없지만 workspace 를 관리해주면 Postman 를 활용하기 좋다.

아래 Workspaces 를 클릭

Create Workspace 클릭

​

Name 란에 OpenAIAPI 를 입력, 개인작업용으로 Personal 선택 후 Create Workspace 클릭

작업공간을 만들었으면 이제 그룹을 만들면 된다.

Create Collection 버튼 클릭

​

Collection 이름 변경 아래 이미지 하이라트 부분을 OpenAI 라고 변경해준다.

OpenAI API 연동 인증은 Bearer Token 방식임으로 셀렉트 박스에서 Bearer Token 문자를 선택해준다.

​

Type 에서 Bearer Token 을 선택하면 하단에 Token 입력값이 나오는데 이 부분을 더블 클릭 해주면

Set as variable 팝업이 뜨고 variable 을 설정해주면 내가 프로그램 변수처럼 활용이 가능하다.

Set as variale 클릭하면 Name 에 OpenAI-API-Key, Value는 내가 이미 저장했던 값,

Scope는 방금 만든 OpenAI Collection 을 선택하면 변수할당은 끝난다.

Set Variable 클릭하면 Token 입력란에 {{OpenAI-API-Key}} 들어간 것을 확인할 수 있다.

이제 OpenAI Collection 안에서는 저 변수를 자유롭게 사용이 가능하다.

이렇게 Collection으로 해주는 이유는 Request 를 하나씩 만들때마다 인증 부분을 각각 설정해주어야 하는데

동일한 인증으로 사용이 가능할 때에는 이렇게 Collection 으로 설정해주는게 편리하다.

​

Collection 까지 만들었으면 이제 Request 를 만들어보자

File -> New ... -> Get Http Request 를 선택 또는 아래 빨간 박스로 클릭해서 새로운 Request 를 생성해준다.

​

Get url 에 아래와 같이 입력

https://api.openai.com/v1/models

​

url 를 입력후 Save 버튼을 클릭하면 아래와 같은 레이어 팝업이 뜨는데

Requst Name 은 Models

Select a Collection 은 OpenAI (마우스클릭) -> Save

Request 를 저장하고 실행 (Send 버튼)

모델에 관한 기본 정보값들을 확인할 수 있다.

​

기본 API 통신은 확인이 되었고 오늘의 목적지인 질문과 답을 받아보는 API 를 설정해보자

​

다시 New 버튼 클릭 (또는 + 버튼)

Requst Name 은 Completions

Select a Collection 은 OpenAI (마우스클릭) -> Save

Get -> Post 로 변경

URL : https://api.openai.com/v1/completions

​

질문을 하기 위해서는 Body 클릭 -> raw (라디오 버튼 선택) -> 마지막 JSON 으로 선택

입력값은 아래와 같이 넣어준다.

{
  "model": "text-davinci-003",
  "prompt": "초보자가 익히기 쉬운 웹 프로그램 언어는 어떤게 있을까? 쉬운 순서대로 10개 나열해줘",
  "max_tokens": 64,
  "temperature": 0.5
}

 

* 마지막 JSON 으로 변경을 해주면 Header에 Content-Type 값이 application/json 으로 변경된다.

이렇게 설정후 실행버튼을 클릭하면

1번 HTML, CSS... 부터 10번 Go 언어까지 답변을 해준다.

질의하는 파라미터 부분은 https://platform.openai.com/docs/api-reference 이 페이지를 참고 하면 된다.