문서 요약
    • PDF

    문서 요약

    • PDF

    Article Summary

    문서요약 API

    다양한 주제의 한국어 원문(문서)으로부터 핵심 문장을 추출하여 1~2줄로 요약하는 서비스로 그 결과를 반환하는 HTTP 기반의 REST API입니다.

    요청

    POST https://naveropenapi.apigw.ntruss.com/text-summary/v1/summarize
    

    요청 헤더

    헤더명설명
    X-NCP-APIGW-API-KEY-ID앱 등록 시 발급받은 Client ID
    X-NCP-APIGW-API-KEY-ID:{Client ID}
    X-NCP-APIGW-API-KEY앱 등록 시 발급 받은 Client Secret
    X-NCP-APIGW-API-KEY:{Client Secret}
    Content-Type바이너리 전송 형식
    Content-Type: application/json

    요청 바디

    필드명필수 여부타입설명
    documentYesDocumentObject요약할 문서
    optionYesOptionObject요약 옵션

    DocumentObject

    필드명필수 여부타입설명
    contentYesString
    titleNoString
    참고

    본문(content), 제목(title) 필드를 모두 합쳐서 2,000자 이내로 사용해야 합니다.
    본문(content) 필드는 문장 분리기에 의해 분리된 문장이 하나 이상 있어야 하며, 문장 분리기는 한 문장이 5 어절 이상이어야 하고 200 자 이하인 경우에만 문장으로 취급합니다.

    OptionObject

    필드명필수 여부타입설명value
    languageYesString문서의 언어* ko: 한국어
    * ja: 일본어
    modelNoString- 요약에 사용할 모델,
    -미지정 시 일반 문서 요약 모델 사용
    * general: 일반 문서 요약
    * news: 뉴스 요약
    toneNoInt- 요약된 결과의 어투 변환
    - 미지정 시 원문의 어투를 유지
    - 단, language=ko 옵션을 선택할 경우만 적용
    * 0: 원문의 어투를 유지
    * 1: 해요체로 변환합니다.
    <예시> 조사한다 → 조사해요
    * 2: 정중체로 변환합니다.
    예시)조사한다 → 조사합니다
    * 3: 명사형 종결체로 변환합니다.
    <예시> 조사한다 → 조사함
    summaryCountNoInt- 요약된 문서의 문장 수
    - 미지정 시 기본 값: 3

    응답

    응답 바디

    필드 이름데이터 타입설명
    summaryString요약된 문서

    예시

    요청 예시(한국어)

    {
      "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"
      }
    }
    

    오류 코드

    HttpStatusCodeErrorCodeErrorMessageDescription
    400E001Unsupported empty or blank text빈 문자열 or blank 문자
    400E002Utf-8 encoding errorUTF-8 인코딩 에러
    400E003Text quota Exceeded문장이 기준치보다 초과 했을 경우
    400E100insufficient valid sentence유효한 문장이 부족한 경우
    400E101Unsupported languageko, ja 가 아닌 경우
    400E102Unsupported modelgeneral, news 가 아닌 경우
    400E103Invalid request bodyrequest body의 json format이 유효하지 않거나 필수 파라미터가 누락된 경우
    400E415Unsupported media typecontent-type 에러
    400E900Unexpected error예외처리가 안된 경우(Bad Request)
    500E501Endpoint connection failed엔드포인트 연결 실패
    500E900Unexpected error예외처리가 안된 오류(Server Error)

    이 문서가 도움이 되었습니까?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.