文書要約
- 印刷する
- 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)フィールドは、文章分離器によって分離された文章を1つ以上含む必要があり、文章分離器は一つの文章が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億」、膨らむ 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"
}
}
エラーコード
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) |
この記事は役に立ちましたか?