학습 모델 Chat Completions

Classic/VPC 환경에서 이용 가능합니다.

학습 모델을 활용하여 대화형 문장을 생성합니다. 만약 원하는 대화형 문장이 생성되지 않았다면 데이터셋을 정제하여 학습을 다시 수행하거나, 요청 파라미터 값을 수정한 후 다시 호출하여 의도했던 결괏값에 최적으로 수렴하도록 조정합니다.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

헤더

헤더에 대한 설명은 다음과 같습니다.

경로 파라미터

파라미터에 대한 설명은 다음과 같습니다.

바디

요청 바디의 각 필드에 대한 설명은 다음과 같습니다.

구문

구문 예시는 다음과 같습니다.

curl --location --request POST 'https://clovastudio.stream.ntruss.com/testapp/v1/tasks/{taskId}/chat-completions' \
--header 'X-NCP-CLOVASTUDIO-API-KEY: <X-NCP-CLOVASTUDIO-API-KEY>' \
--header 'X-NCP-APIGW-API-KEY: <X-NCP-APIGW-API-KEY>' \
--header 'X-NCP-CLOVASTUDIO-REQUEST-ID: <X-NCP-CLOVASTUDIO-REQUEST-ID>' \
--header 'Content-Type: application/json' \
--header 'Accept: text/event-stream' \
--data '{
  "topK" : 0,
  "includeAiFilters" : true,
  "maxTokens" : 100,
  "temperature" : 0.3,
  "messages" : [ {
    "role" : "user",
    "content" : "오늘 날씨 어때?"
  }, {
    "role" : "assistant",
    "content" : "폭풍전야입니다."
  }, {
    "role" : "user",
    "content" : "내일 날씨는 어때?"
  } ],
  "stopBefore" : [ ],
  "repeatPenalty" : 1,
  "topP" : 0.8
}'

응답

응답 형식을 설명합니다.

헤더

헤더에 대한 설명은 다음과 같습니다.

바디

바디의 각 필드에 대한 설명은 다음과 같습니다.

구문

구문 예시는 다음과 같습니다.

{
  "status": {
    "code": "20000",
    "message": "OK"
  },
  "result": {
    "message": {
      "role": "assistant",
      "content": "문구: 오늘 하루 있었던 일들을 기록하며, 내일을 준비하세요. 다이어리는 당신의 삶을 더욱 풍요롭게 만들어 줄 것입니다.\n"
    },
    "stopReason": "LENGTH",
    "inputLength": 100,
    "outputLength": 10,
    "aiFilter": [
      {
        "groupName": "curse",
        "name": "insult",
        "score": "1"
      },
      {
        "groupName": "curse",
        "name": "discrimination",
        "score": "0"
      },
      {
        "groupName": "unsafeContents",
        "name": "sexualHarassment",
        "score": "2"
      }
    ]
  }
}

응답 스트림

생성되는 토큰을 하나씩 출력하도록 토큰 스트리밍을 사용할 수 있습니다. 토큰 스트리밍 형식을 설명합니다.

헤더

헤더에 대한 설명은 다음과 같습니다.

바디

바디에 대한 설명은 다음과 같습니다.

StreamingChatCompletionsResultEvent

StreamingChatCompletionsResultEvent에 대한 설명은 다음과 같습니다.

StreamingChatCompletionsTokenEvent

StreamingChatCompletionsResultEvent에 대한 설명은 다음과 같습니다.

ErrorEvent

ErrorEvent에 대한 설명은 다음과 같습니다.

SignalEvent

SignalEvent에 대한 설명은 다음과 같습니다.

구문

구문 예시는 다음과 같습니다.

id: aabdfe-dfgwr-edf-hpqwd-f2asd-g
event: token
data: {"message": {"role": "assistant", "content": “안”}}

id: aabdfe-dfgwr-edf-hpqwd-f1asd-g
event: result
data: {"message": {"role": "assistant", "content": “녕 }}