chatGPT 3.5 Turbo

chatGPT로 대표되는 openAI사의 AI 상품입니다.

사전에 openai 홈페이지(https://openai.com/)를 통하여 파트너 가입이 되어야 하며, OPENAI_API_KEY 가 준비 되어 있어야 합니다.

(OPENAI_API_KEY발급에 어려움이 있는 경우, API PLEX 고객센터로 연락하여 발급을 요청 할 수 있습니다.)

API 명세

캐릭터 인코딩은 UTF-8이 기본 값입니다.

Request Body 예시

{
  "model": "gpt-3.5-turbo",
  "messages": [
    {
      "role": "user",
      "content": "개발자에게 좋은 운동은 뭐가 있을까?"
    }
  ]
}

Chat GPT에게 질문하고 응답을 받는 API

POST https://4vh6qtie3c.apigw.ntruss.com/openai/v1/chat/completions

Headers

Name	Type	Description
Content-Type*	String	application/json;charset=utf-8
Authorization*	String	사용자ID;secret key

Request Body

Name	Type	Description
model*	String	모델 명 (gpt-3.5-turbo)
messages*	Object Array
role*	String	system, user, assistant 중 선택 가능 GPT에게 이전 상황에 대하여 설명 하고자 할 때 사용하며, 단일 질문을 할 때는 user 값을 사용합니다.
content*	String	role 이 system인 경우 상황에 대한 설명이 들어가고, Assistant 인 경우 이전 대화 맥락의 설명을 위한 답변했던 내용이 들어갑니다. user의 경우 질문의 내용이 들어갑니다.

200: OK 응답 반환 완료

{
  "created": 1679042989,
  "usage": {
      "completion_tokens": 196,
      "prompt_tokens": 23,
      "total_tokens": 219
  },
  "model": "gpt-3.5-turbo-0301",
  "id": "chatcmpl-6v04TSTKG3QatxvxB6Ss0vQ40teY0",
  "choices": [
      {
          "finish_reason": "stop",
          "index": 0,
          "message": {
              "role": "assistant",
              "content": "개발자에게 좋은 운동은 유산소 운동, 근력 훈련, 스트레칭, 요가와 같은 활동을 통해 정기적인 운동 습관을 유지하는 것입니다."
          }
      }
  ],
  "object": "chat.completion"
}

Response 상태 값

모든 Response는 반드시 아래 표에 해당하는 finish_reason 값을 포함합니다.

응답 값	설명
stop	API가 완전한 모델 출력을 반환했습니다.
lengthmax_tokens	매개변수 또는 토큰 제한 으로 인해 불완전한 모델 출력
content_filter	콘텐츠 필터 플래그로 인해 콘텐츠 누락
null	API 응답이 아직 진행 중이거나 완료되지 않음

토큰관리

토큰은 일종의 답변 길이이며, 한 문자가 될 수도, 한단어가 될 수도 있습니다.

토큰 관리 정책은 아래의openAI 사 정책을 따릅니다.

문자열 "ChatGPT is great!"은 6개의 토큰으로 인코딩됩니다.

["Chat", "G", "PT", " is", " great", "!"].

API 응답에 포함된 total_tokens 필드값은 과금에 사용되오니 참고 바랍니다.