문서 요약
- 인쇄
- PDF
문서 요약
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
문서요약 API
다양한 주제의 한국어 원문(문서)으로부터 핵심 문장을 추출하여 1~2줄로 요약하는 서비스로 그 결과를 반환하는 HTTP 기반의 REST API입니다.
요청
POST https://naveropenapi.apigw.ntruss.com/text-summary/v1/summarize
요청 헤더
헤더명 | 설명 |
---|---|
X-NCP-APIGW-API-KEY-ID | 앱 등록 시 발급받은 Client IDX-NCP-APIGW-API-KEY-ID:{Client ID} |
X-NCP-APIGW-API-KEY | 앱 등록 시 발급 받은 Client SecretX-NCP-APIGW-API-KEY:{Client Secret} |
Content-Type | 바이너리 전송 형식Content-Type: application/json |
요청 바디
필드명 | 필수 여부 | 타입 | 설명 |
---|---|---|---|
document | Yes | DocumentObject | 요약할 문서 |
option | Yes | OptionObject | 요약 옵션 |
DocumentObject
필드명 | 필수 여부 | 타입 | 설명 |
---|---|---|---|
content | Yes | String | |
title | No | String |
참고
본문(content), 제목(title) 필드를 모두 합쳐서 2,000자 이내로 사용해야 합니다.
본문(content) 필드는 문장 분리기에 의해 분리된 문장이 하나 이상 있어야 하며, 문장 분리기는 한 문장이 5 어절 이상이어야 하고 200 자 이하인 경우에만 문장으로 취급합니다.
OptionObject
필드명 | 필수 여부 | 타입 | 설명 | value |
---|---|---|---|---|
language | Yes | String | 문서의 언어 | * ko: 한국어 * ja: 일본어 |
model | No | String | - 요약에 사용할 모델, -미지정 시 일반 문서 요약 모델 사용 | * general: 일반 문서 요약 * news: 뉴스 요약 |
tone | No | Int | - 요약된 결과의 어투 변환 - 미지정 시 원문의 어투를 유지 - 단, language=ko 옵션을 선택할 경우만 적용 | * 0: 원문의 어투를 유지 * 1: 해요체로 변환합니다. <예시> 조사한다 → 조사해요 * 2: 정중체로 변환합니다. 예시)조사한다 → 조사합니다 * 3: 명사형 종결체로 변환합니다. <예시> 조사한다 → 조사함 |
summaryCount | No | Int | - 요약된 문서의 문장 수 - 미지정 시 기본 값: 3 |
응답
응답 바디
필드 이름 | 데이터 타입 | 설명 |
---|---|---|
summary | String | 요약된 문서 |
예시
요청 예시(한국어)
{
"document": {
"title": "'하루 2000억' 판 커지는 간편송금 시장",
"content": "간편송금 이용금액이 하루 평균 2000억원을 넘어섰다. 한국은행이 17일 발표한 '2019년 상반기중 전자지급서비스 이용 현황'에 따르면 올해 상반기 간편송금서비스 이용금액(일평균)은 지난해 하반기 대비 60.7% 증가한 2005억원으로 집계됐다. 같은 기간 이용건수(일평균)는 34.8% 늘어난 218만건이었다. 간편 송금 시장에는 선불전자지급서비스를 제공하는 전자금융업자와 금융기관 등이 참여하고 있다. 이용금액은 전자금융업자가 하루평균 1879억원, 금융기관이 126억원이었다. 한은은 카카오페이, 토스 등 간편송금 서비스를 제공하는 업체 간 경쟁이 심화되면서 이용규모가 크게 확대됐다고 분석했다. 국회 정무위원회 소속 바른미래당 유의동 의원에 따르면 카카오페이, 토스 등 선불전자지급서비스 제공업체는 지난해 마케팅 비용으로 1000억원 이상을 지출했다. 마케팅 비용 지출규모는 카카오페이가 491억원, 비바리퍼블리카(토스)가 134억원 등 순으로 많았다."
},
"option": {
"language": "ko",
"model": "news",
"tone": 2,
"summaryCount": 3
}
}
응답 예시(한국어)
{
"summary": "간편송금 이용금액이 하루 평균 2000억원을 넘어섰습니다.\n한은은 카카오페이, 토스 등 간편송금 서비스를 제공하는 업체 간 경쟁이 심화되면서 이용규모가 크게 확대됐다고 분석했습니다.\n국회 정무위원회 소속 바른미래당 유의동 의원에 따르면 카카오페이, 토스 등 선불전자지급서비스 제공업체는 지난해 마케팅 비용으로 1000억원 이상을 지출했습니다."
}
요청 예시(일본어)
{
"document": {
"title": "三菱電機、杉山社長が辞任表明 検査不正で引責",
"content": "鉄道向け空調機器などで検査不正が発覚した三菱電機の杉山武史社長は2日、東京都内で記者会見し、社長を辞任すると発表した。杉山社長は「多くの方々に多大なるご迷惑とご心配をおかけし、誠に申し訳ございません。複数の品質事案が判明しており、自ら発見、是正できなかったことを深くおわび申し上げます」と陳謝した。\n【図解】三菱電機が行っていた検査偽装の流れ\n同社は外部の弁護士を委員長とする調査委員会を設置。9月に調査結果と再発防止策を公表すると発表した。\n杉山社長は「ガバナンスの強化とよりよい風土の醸成は社長に課せられた重大な使命。2018年の就任以降、現在までの経緯を踏まえ、私がこの任にあることがすべてのステークホルダーにご理解いただけるか何度も自問した。そして結論として、社長を辞任することが適切と判断した」と説明した。\n三菱電機は6月14日、社内調査で不正を把握した。6月29日に毎日新聞などの報道で問題が明らかになったが、記者会見を開いたのは今回が初めて。\n不正検査をしていたのは、鉄道向け製品を製造している長崎製作所(長崎県時津町)。空調機器の冷暖房の機能や省エネ性能、防水などの検査で、顧客との契約とは違う方法で検査したり、検査をせずに架空のデータを成績書に記入したりしていた。"
},
"option": {
"language": "ja",
"model": "general"
}
}
응답 예시(일본어)
{
"summary": "鉄道向け空調機器などで検査不正が発覚した三菱電機の杉山武史社長は2日、東京都内で記者会見し、社長を辞任すると発表した。\nそして結論として、社長を辞任することが適切と判断した」と説明した。\n三菱電機は6月14日、社内調査で不正を把握した。"
}
오류
오류 예시
{
"status": 400,
"error": {
"errorCode": "E001",
"message": "Unsupported empty or blank text"
}
}
오류 코드
HttpStatusCode | ErrorCode | ErrorMessage | Description |
---|---|---|---|
400 | E001 | Unsupported empty or blank text | 빈 문자열 or blank 문자 |
400 | E002 | Utf-8 encoding error | UTF-8 인코딩 에러 |
400 | E003 | Text quota Exceeded | 문장이 기준치보다 초과 했을 경우 |
400 | E100 | insufficient valid sentence | 유효한 문장이 부족한 경우 |
400 | E101 | Unsupported language | ko, ja 가 아닌 경우 |
400 | E102 | Unsupported model | general, news 가 아닌 경우 |
400 | E103 | Invalid request body | request body의 json format이 유효하지 않거나 필수 파라미터가 누락된 경우 |
400 | E415 | Unsupported media type | content-type 에러 |
400 | E900 | Unexpected error | 예외처리가 안된 경우(Bad Request) |
500 | E501 | Endpoint connection failed | 엔드포인트 연결 실패 |
500 | E900 | Unexpected error | 예외처리가 안된 오류(Server Error) |
이 문서가 도움이 되었습니까?