CLOVA Summary API 파이썬으로 사용하기

최근 네이버 클로바에서 긴 문서를 요약해 핵심 문장을 뽑아내 주는 Summary API를 새롭게 출시했습니다.

 

https://www.ncloud.com/product/aiService/clovaSummary

NAVER CLOUD PLATFORM

 

 

 

저는 졸업 작품 프로젝트로 비슷한 딥러닝을 통한 문서 요약 모델을 구현 중이었는데요. Clova Summary도 써보지 않을 수 없겠죠?

 

https://api.ncloud-docs.com/docs/ai-naver-clovasummary

CLOVA Summary 개요 - CLOVA Summary

 

사용 가이드를 참조하여 파이썬으로 구현해 보았습니다.

 

 

우선 콘솔의 Products & Services 메뉴에서 AI·NAVER API로 들어가 Application을 등록해 줍니다.

저는 북마크로 설정해 놓아 북마크에서도 쉽게 들어갈 수 있습니다.

 

 

Application 등록 버튼을 누르면 Application 이름을 설정하고 서비스를 선택하는 창이 뜹니다.

CLOVA Summary만 사용해 볼 것이므로, CLOVA Summary를 선택해 줍니다.

 

서비스 환경도 등록하면 되는데요. 저는 Django Web에서 사용해 볼 거라 장고 서버인 http://127.0.0.0:8000를 등록해 주었습니다.

안드로이드 앱이나 iOS앱에서 사용하실 분들은 따로 패키지 이름이나 번들 아이디를 등록해 주시면 되겠습니다.

 

 

그러면 등록한 App이 이렇게 뜹니다. 인증 정보를 누르면 

클라이언트 ID와 클라이언트 시크릿 키를 확인하실 수 있습니다.

 

 

 

파이썬으로 Summary API를 구현한 예시는 다음과 같습니다.

예시 코드는 CLOVA Speech 예시를 참고했습니다.

#!/usr/bin/python
# -*- coding: utf-8 -*-
import sys
import requests
import json
import my_settings

client_id = my_settings.CLIENT_ID
client_secret = my_settings.CLIENT_SECRET
url = 'https://naveropenapi.apigw.ntruss.com/text-summary/v1/summarize'

headers = {
            'Accept': 'application/json;UTF-8',
            'Content-Type': 'application/json;UTF-8',
            'X-NCP-APIGW-API-KEY-ID': client_id,
            'X-NCP-APIGW-API-KEY': client_secret
        }

data = {
  "document": {
    "content": "간편송금 이용금액이 하루 평균 2000억원을 넘어섰다. 한국은행이 17일 발표한 '2019년 상반기중 전자지급서비스 이용 현황'에 따르면 올해 상반기 간편송금서비스 이용금액(일평균)은 지난해 하반기 대비 60.7% 증가한 2005억원으로 집계됐다. 같은 기간 이용건수(일평균)는 34.8% 늘어난 218만건이었다. 간편 송금 시장에는 선불전자지급서비스를 제공하는 전자금융업자와 금융기관 등이 참여하고 있다. 이용금액은 전자금융업자가 하루평균 1879억원, 금융기관이 126억원이었다. 한은은 카카오페이, 토스 등 간편송금 서비스를 제공하는 업체 간 경쟁이 심화되면서 이용규모가 크게 확대됐다고 분석했다. 국회 정무위원회 소속 바른미래당 유의동 의원에 따르면 카카오페이, 토스 등 선불전자지급서비스 제공업체는 지난해 마케팅 비용으로 1000억원 이상을 지출했다. 마케팅 비용 지출규모는 카카오페이가 491억원, 비바리퍼블리카(토스)가 134억원 등 순으로 많았다."
  },
  "option": {
    "language": "ko",
    "model": "news",
    "tone": 2,
    "summaryCount": 3
  }
}

response = requests.post(url, headers=headers, data=json.dumps(data).encode('UTF-8'))
rescode = response.status_code
if(rescode == 200):
    print (response.text)
else:
    print("Error : " + response.text)

 

document 필드 내에는 content 필드와 title 필드를 넣을 수 있고, title은 필수 필드가 아니어서 제외했습니다. content와 title 필드를 합쳐 2000자 내로만 요약이 가능합니다.

 

option 필드 내에는 language, model, tone, summaryCount 필드를 넣을 수 있고 language 필드만 필수로 지정해 주면 됩니다. 현재는 한국어와 일본어만 지원합니다. 나머지 사항은 API 가이드를 참고하세요.

 

 

저는 클라이언트 ID와 Secret은 my_settings.py 파일을 새로 만들어 임포트하는 형식을 사용했습니다.

위 파일과 같은 위치에 my_settings.py를 만들어 다음과 같이 사용하시면 됩니다.

 

CLIENT_ID = '본인의 클라이언트 아이디'
CLIENT_SECRET = '본인의 클라이언트 시크릿'

 

 

저의 깃허브에 2000자 이상의 문서도 끊어서 요약하는 간략한 코드가 있으니 필요하시다면 참고해 주시기 바랍니다. 

https://github.com/ttaerrim/ncloud_summary

GitHub - ttaerrim/ncloud_summary