文書要約
    • 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)フィールドは、文章分離器によって分離された文章を1つ以上含む必要があり、文章分離器は一つの文章が5語節以上、200字以下の場合にのみ文章として扱います。

    OptionObject

    フィールド名要否タイプ説明value
    languageYesString文書の言語* ko: 韓国語
    * ja: 日本語
    modelNoString- 要約に使用するモデル、
    - 指定しない場合は一般文書の要約モデルを使用
    * general: 一般文書の要約
    * news: ニュースの要約
    toneNoInt- 要約された結果の語調を変換
    - 指定しない場合は原文の語調を維持
    - ただし、language=koオプションを選択する場合にのみ適用
    * 0: 原文の口調を維持
    * 1: ですます調に変換します。
    例) 調査する → 調査します
    * 2: 丁寧体に変換します。
    例) 調査する → 調査いたします
    * 3: 体言止めに変換します。
    例) 調査する → 調査
    summaryCountNoInt- 要約された文書の文章数
    - 指定しない場合はデフォルト値: 3

    レスポンス

    レスポンスボディ

    フィールド名データタイプ説明
    summaryString要約された文書

    リクエスト例(韓国語)

    {
      "document": {
        "title": "「一日2000億」、膨らむ P2P金融サービス市場",
        "content": "P2P金融サービスの利用金額が一日平均2000億ウォンを超えた。17日、韓国銀行が発表した「2019年上半期中の電子マネーサービスの利用状況」によると、今年上半期の P2P金融サービス利用金額(一日平均)は、昨年下半期比60.7%増の2,005億ウォンと集計された。同期間の利用件数(一日平均)は34.8%増の218万件だった。P2P金融サービス市場には、プリペイド型電子マネーサービスを提供する電子金融会社や金融機関などが参加している。利用金額は、電子金融業者が一日平均1,879億ウォン、金融機関が126億ウォンだった。韓国銀行は KakaoPay、Tossなど P2P金融サービスを提供する企業間競争が激化するにつれ、利用金額の規模が大幅に拡大したと分析した。国会の政務委員会所属の正しい未来党ユ・ウィドン議員によると、KakaoPay、Tossなどプリペイド型電子マネーサービスの提供会社は去年、マーケティングコストとして1000億ウォン以上を支出した。マーケティングコストの支出規模は KakaoPayが491億ウォン、Viva Republica Inc.(Toss)が134億ウォンなどの順に大きかった。"
      },
      "option": {
        "language": "ko",
        "model": "news",
        "tone": 2,
        "summaryCount": 3
      }
    }
    

    レスポンス例(韓国語)

    {
        "summary": "P2P金融サービスの利用金額が一日平均2000億ウォンを超えました。\n韓国銀行は KakaoPay、Tossなど P2P金融サービスを提供する企業間競争が激化するにつれ、利用金額の規模が大幅に拡大したと分析しました。\n国会の政務委員会所属の正しい未来党ユ・ウィドン議員によると KakaoPay、Tossなどプリペイド型電子マネーサービスの提供会社は去年、マーケティングコストとして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.