API & DATA

長文要約生成API

長文要約生成API

長い文章から、各文を圧縮したり、指定文字数ごとに区切って要約したり、重要な文を抽出したりするAPIです。比較的長い文章全体を把握する際に活用頂けます。

お知らせ

上記「APIキー取得」リンクでは、「自動要約生成API」のAPIキーが取得されるバグが有りました。現在は修正しましたので、改めて取得をお願いいたします。なお、本記事の後半にある「APIキー取得」ボタンからは正常にAPIキーが発行できておりました。お詫び申し上げます。

長文要約生成

本APIは、入力された記事本文を機械学習を用いて要約するものです。過去30年分の記事データを、ディープラーニングの機構を用いて学習させています。長文を要約するときにお役立てください。

本APIの機能は、

  • 指定した長さごとに生成型要約
  • すべての文の長さを揃える
  • すべての文を圧縮する
  • 重要な文を抽出する
  • 重要な文を抽出後圧縮して、指定した長さにする
の5つです。

リファレンス

本APIは、記事本文の入力に対して要約を生成します。

入力

九州電力玄海原発3、4号機(佐賀県玄海町)の運転差し止めを住民らが求めた仮処分申し立ての即時抗告審で、福岡高裁(山之内紀行裁判長)は10日、住民側の抗告を棄却した。主な争点は、耐震設計の基になる基準地震動(想定される最大の揺れ)の合理性、原発周辺の火山の噴火リスク、配管の安全性の3点。 住民側は「基準地震動が過小評価されている」と主張。原子力規制委員会の安全審査の内規(火山影響評価ガイド)は、破局的噴火が予測できることを前提としている点は不合理と指摘。阿蘇カルデラ火山の噴火による火砕流が原発の敷地に到達する可能性も、十分小さいとは言えないと訴えていた。配管については「九電の検査方法では損傷が見逃されることがありうる」としていた。九電側は、基準地震動の評価について「各種調査で地域的な特性を把握した上、過小にならないようにしており合理的だ」と反論。「原発の運用期間中に破局的噴火が起きる可能性は極めて低い」と主張していた。配管については「健全性の確保に向け万全を期している」としていた。佐賀地裁は2017年6月、「安全性に欠けるところがあるとは認められない」などとして、仮処分の申し立てを却下。住民側が即時抗告していた。

指定した長さごとに生成型要約(200文字ごと)

  • 九州電力玄海原発3、4号機(佐賀県)の運転差し止め仮処分申し立てで、福岡高裁は住民側の抗告を棄却した。耐震設計の基になる基準地震動(想定される最大の揺れ)が過小評価されている。
  • 阿蘇カルデラ火山の噴火による火砕流が原発の敷地に到達する可能性も、十分小さいとは言えないと訴えていた。住民側は即時抗告していた。

すべての文の長さを揃える(30文字に揃える)

  • 福岡高裁(山之内紀行裁判長)は、住民側の抗告を棄却した。
  • 原発周辺の火山の噴火リスク、配管の安全性の3点。
  • 住民側は「基準地震動が過小評価されている」と主張。
  • 原子力規制委員会の安全審査の内規(火山影響評価ガイド)は不合理と指摘。
  • 原発の敷地に到達する可能性も、十分小さいとは言えないと訴えていた。
  • 「九電の検査方法では損傷が見逃されることがありうる」としていた。
  • 「各種調査で地域的な特性を把握した上、過小にならないようにしており合理的だ」
  • 「原発の運用期間中に破局的噴火が起きる可能性は極めて低い」と主張していた。
  • 配管については「健全性の確保に向け万全を期している」としていた。
  • 佐賀地裁は2017年6月、「安全性に欠けるところがあるとは認められない」
  • 住民側が即時抗告していた。

すべての文を圧縮する(圧縮率:低=30%削減)

  • 九州電力玄海原発3、4号機(佐賀県)の運転差し止めを住民が求めた仮処分申し立ての即時抗告審で、福岡高裁(山之内紀行裁判長)は10日、棄却した。
  • 耐震設計の基になる基準地震動(想定される最大の揺れ)の合理性、原発周辺の火山の噴火リスクの3点。
  • 住民側は「基準地震動が過小評価されている」と主張。
  • 原子力規制委員会の安全審査の内規は、破局的噴火が予測できることを前提としている点は不合理と指摘。
  • 噴火による火砕流が原発の敷地に到達する可能性も、十分小さいとは言えないと訴えていた。
  • 「九電の検査方法では損傷が見逃されることがありうる」としていた。
  • 基準地震動の評価について「各種調査で地域的な特性を把握した上、過小にならないようにしており合理的だ」
  • 「原発の運用期間中に破局的噴火が起きる可能性は極めて低い」と主張。
  • 「健全性の確保に向け万全を期している」としていた。
  • 佐賀地裁は2017年6月、「安全性に欠けるところがあるとは認められない」などとして却下。
  • 住民側が即時抗告していた。

重要な文を抽出する(圧縮率:中=50%削減)

  • 住民側は「基準地震動が過小評価されている」と主張。
  • 九電側は、基準地震動の評価について「各種調査で地域的な特性を把握した上、過小にならないようにしており合理的だ」と反論。
  • 「原発の運用期間中に破局的噴火が起きる可能性は極めて低い」と主張していた。
  • 配管については「健全性の確保に向け万全を期している」としていた。
  • 住民側が即時抗告していた。

重要な文を抽出後圧縮して、指定した長さにする(200文字に圧縮)

  • 住民側は「基準地震動が過小評価されている」と主張。
  • 配管については「九電の検査方法では損傷が見逃されることがありうる」としていた。
  • 九電側は、基準地震動の評価について「各種調査で地域的な特性を把握した上、過小にならないようにしており合理的だ」と反論。
  • 「原発の運用期間中に破局的噴火が起きる可能性は極めて低い」と主張していた。
  • 配管については「健全性の確保に向け万全を期している」としていた。
  • 住民側が即時抗告していた。

エンドポイントとリクエストパラメータ

指定した長さごとに生成型要約

文章を指定した長さごとに区切り、それぞれのブロックごとに生成型要約を生成します。

URL:https://clapi.asahi.com/abstract

method:POST

レスポンス: JSON

パラメータ名 説明 サンプル 制約 必須
text 記事本文を指定します。 米ホワイトハウスは18日、トランプ大統領と北朝鮮の金正恩朝鮮労働党委員長による2回目の米朝首脳会談が2月下旬に開かれることを明らかにした。.... 日本語文字列。100文字以上2000文字以下。2000文字を超えると、超過分は切り捨てて処理します。
length 何文字ずつ区切って要約するか指定します。この値が長いほど要約は短くなります。 200 200〜2000の整数。デフォルトは500。 -
auto_paragraph 自動的に段落分けをするか否かを指定します。有効にした場合、段落と推測される単位を自動で判定し、段落単位に複数の文が結合されて返却されます。 false true/false(デフォルト) -

すべての文の長さを揃える

文章中の各々の文を、指定した長さまで圧縮します。

URL:https://clapi.asahi.com/align

method:POST

レスポンス: JSON

パラメータ名 説明 サンプル 制約 必須
text 記事本文を指定します。 米ホワイトハウスは18日、トランプ大統領と北朝鮮の金正恩朝鮮労働党委員長による2回目の米朝首脳会談が2月下旬に開かれることを明らかにした。.... 日本語文字列。100文字以上2000文字以下。2000文字を超えると、超過分は切り捨てて処理します。
length 圧縮後の1文の長さを指定します。 25 10〜50の整数。デフォルトは25。 -
auto_paragraph 自動的に段落分けをするか否かを指定します。有効にした場合、段落と推測される単位を自動で判定し、段落単位に複数の文が結合されて返却されます。 false true/false(デフォルト) -

すべての文を圧縮する

文章中の各々の文を、指定した割合まで文字数を圧縮します。

URL:https://clapi.asahi.com/abstract

method:POST

レスポンス: JSON

パラメータ名 説明 サンプル 制約 必須
text 記事本文を指定します。 米ホワイトハウスは18日、トランプ大統領と北朝鮮の金正恩朝鮮労働党委員長による2回目の米朝首脳会談が2月下旬に開かれることを明らかにした。... 日本語文字列。100文字以上2000文字以下。2000文字を超えると、超過分は切り捨てて処理します。
rate 1文を何割程度の文字数に圧縮するかを指定します。 0.7 0.1〜0.9の少数。デフォルトは0.7。この数値が小さいほど、返却される文の文字数は少なくなります(高圧縮)。 -
auto_paragraph 自動的に段落分けをするか否かを指定します。有効にした場合、段落と推測される単位を自動で判定し、段落単位に複数の文が結合されて返却されます。 false true/false(デフォルト) -

重要な文を抽出する

すべての文から指定した割合で、重要な文を抜き出す

URL:https://clapi.asahi.com/extract

method:POST

レスポンス: JSON

パラメータ名 説明 サンプル 制約 必須
text 記事本文を指定します。 米ホワイトハウスは18日、トランプ大統領と北朝鮮の金正恩朝鮮労働党委員長による2回目の米朝首脳会談が2月下旬に開かれることを明らかにした。.... 日本語文字列。100文字以上2000文字以下。2000文字を超えると、超過分は切り捨てて処理します。
rate 全体の文からどのくらいの割合で文を抽出するかを指定します。 0.7 0.1〜0.9の少数。デフォルトは0.7。この数値が小さいほど、返却される文数は少なくなります(高圧縮)。 -
auto_paragraph 自動的に段落分けをするか否かを指定します。有効にした場合、段落と推測される単位を自動で判定し、段落単位に複数の文が結合されて返却されます。 false true/false(デフォルト) -

重要な文を抽出後圧縮して、指定した長さにする

文の抽出と圧縮を組み合わせて、指定した文字数に文を要約します。

URL:https://clapi.asahi.com/control-len

method:POST

レスポンス: JSON

パラメータ名 説明 サンプル 制約 必須
text 記事本文を指定します。 米ホワイトハウスは18日、トランプ大統領と北朝鮮の金正恩朝鮮労働党委員長による2回目の米朝首脳会談が2月下旬に開かれることを明らかにした。 日本語文字列。100文字以上2000文字以下。2000文字を超えると、超過分は切り捨てて処理します。
length 出力する要約文のトータルの長さを指定します。 200 10〜2000の整数。デフォルトは500。 -
auto_paragraph 自動的に段落分けをするか否かを指定します。有効にした場合、段落と推測される単位を自動で判定し、段落単位に複数の文が結合されて返却されます。 false true/false(デフォルト) -

レスポンス

フィールド名 説明 サンプル 返却条件
result 要約文 ["この冬一番の強い寒気が上空に流れ込んだ8日、九州・山口の各地で雪が降った。9日朝にかけて平地でも大雪となるおそれがある。","福岡市博多区で零下2.9度を記録し、各地で今季最低の記録を更新した。福岡市内で凍結した路面でのスリップ事故が相次いでおり、けが人が出た。"] string 要約文が生成可能(HTTP Status=200)だった場合のみ返却。
detail エラー内容 "bad parameters" string 要約文が生成不可能(HTTP Status=200以外)だった場合のみ返却。

エラー時の返却メッセージ

detail HTTP Status 説明
bad parameters 400 パラメータが不正
Missing Authentication Token 403 APIキーが不正
Internal server error 500, 503 サーバ処理で異常が発生
Limit Exceeded 429 アクセス数の制限を超過(1日20アクセス)

サンプルリクエスト

正常時(auto_paragraph=false)

- Request
curl -X POST "https://clapi.asahi.com/compress" -H  "accept: application/json" -H  "Content-Type: application/json" -H "x-api-key: ****" -d "{\"text\":\"この冬一番の強い寒気が上空に流れ込んだ8日、九州・山口の各地で雪が降った。夜から寒気はさらに強まる見込みで、9日朝にかけて平地でも大雪となるおそれがある。¥n福岡管区気象台によると、8日午前9時現在の積雪は山口市8センチ、佐賀市4センチ、福岡市2センチ。9日午前6時までに予想される24時間降雪量は、宮崎を除く九州各県と山口県の山地で20センチ、平地でも10センチで、その後の24時間でも同程度の降雪が予想される。8日の最低気温は福岡市博多区で零下2・9度、北九州市小倉南区で零下3・3度など各地で今季最低を記録した。\\n福岡県警によ ると、福岡市内で7日夜から8日朝にかけて凍結した路面でのスリップ事故が相次いだ。博多区の県道交差点ではトラック3台による玉突き事故が発生。同市南区の市道では乗用車4台と軽乗用車1台が追突する玉突き事故があり、けが人が出た。福岡市消防局によると、雪による転倒などの119番通報は7日午後から8日午前9時までに50件あった。北九州市によると、午前10時までに男女14人が救急搬送されたことを確認。いずれも軽いけがだという。\\n九州北部の広い範囲で交通網が影響を受けた。西日本高速道路などによると、8日正午現在、大分道は全線で、九州道、東九州道、長崎道、西九州道などは一部で上下線が通行止め。福岡都市高速、北九州都市高速も7日深夜から通行止めが続いた。\",\"rate\":0.5,\"auto_paragraph\":false}" -v
- Response
{"result":["8日、九州・山口の各地で雪が降った。","9日朝にかけて平地でも大雪となるおそれがある。","8日午前9時現在の積雪は山口市8センチ、佐賀市4センチ。","九州各県と山口県の山地で20センチ、平地でも10センチで、その後の24時間でも降雪が予想される。","北九州市小倉南区で零下3・3度など各地で今季最低を記録した。","福岡市内で7日夜から8日朝にかけて凍結した路面。","トラック3台による玉突き事故が発生。","4台と軽乗用車1台が追突する玉突き事故があり、けが人が出た。","雪による転倒などの119番通報は7日午後から8日午前9時まで。","午前10時までに男女14人が救急搬送。","いずれも軽いけが。","交通網が影響を受けた。","西日本高速道路などによると、8日正午現在、大分道は全線で通行止め。","北九州都市高速も7日深夜から通行止め。"]}*

正常時(auto_paragraph=true)

- Request
curl -X POST "https://clapi.asahi.com/compress" -H  "accept: application/json" -H  "Content-Type: application/json" -H "x-api-key: ****" -d "{\"text\":\"この冬一番の強い寒気が上空に流れ込んだ8日、九州・山口の各地で雪が降った。夜から寒気はさらに強まる見込みで、9日朝にかけて平地でも大雪となるおそれがある。¥n福岡管区気象台によると、8日午前9時現在の積雪は山口市8センチ、佐賀市4センチ、福岡市2センチ。9日午前6時までに予想される24時間降雪量は、宮崎を除く九州各県と山口県の山地で20センチ、平地でも10センチで、その後の24時間でも同程度の降雪が予想される。8日の最低気温は福岡市博多区で零下2・9度、北九州市小倉南区で零下3・3度など各地で今季最低を記録した。\\n福岡県警によ ると、福岡市内で7日夜から8日朝にかけて凍結した路面でのスリップ事故が相次いだ。博多区の県道交差点ではトラック3台による玉突き事故が発生。同市南区の市道では乗用車4台と軽乗用車1台が追突する玉突き事故があり、けが人が出た。福岡市消防局によると、雪による転倒などの119番通報は7日午後から8日午前9時までに50件あった。北九州市によると、午前10時までに男女14人が救急搬送されたことを確認。いずれも軽いけがだという。\\n九州北部の広い範囲で交通網が影響を受けた。西日本高速道路などによると、8日正午現在、大分道は全線で、九州道、東九州道、長崎道、西九州道などは一部で上下線が通行止め。福岡都市高速、北九州都市高速も7日深夜から通行止めが続いた。\",\"rate\":0.5,\"auto_paragraph\":true}"
- Response
{"result":["8日、九州・山口の各地で雪が降った。9日朝にかけて平地でも大雪となるおそれがある。","8日午前9時現在の積雪は山口市8センチ、佐賀市4センチ。九州各県と山口県の山地で20センチ、平地でも10センチで、その後の24時間でも降雪が予想される。北九州市小倉南区で零下3・3度など各地で今季最低を記録した。","福岡市内で7日夜から8日朝にかけて凍結した路面。トラック3台による玉突き事故が発生。4台と軽乗用車1台が追突する玉突き事故があり、けが人が出た。雪による転倒などの119番通報は7日午後から8日午前9時まで。午前10時までに男女14人が救急搬送。いずれも軽いけが。交通網が影響を受けた。","西日本高速道路などによると、8日正午現在、大分道は全線で通行止め。北九州都市高速も7日深夜から通行止め。"]}

異常時

- Request
curl -X POST "https://clapi.asahi.com/compress" -H  "accept: application/json" -H  "Content-Type: application/json" -H "x-api-key: ****" -d "{\"text\":\"この冬一番の強い寒気が上空に流れ込んだ8日、九州・山口の各地で雪が降った。夜から寒気はさらに強まる見込みで、9日朝にかけて平地でも大雪となるおそれがある。¥n福岡管区気象台によると、8日午前9時現在の積雪は山口市8センチ、佐賀市4センチ、福岡市2センチ。9日午前6時までに予想される24時間降雪量は、宮崎を除く九州各県と山口県の山地で20センチ、平地でも10センチで、その後の24時間でも同程度の降雪が予想される。8日の最低気温は福岡市博多区で零下2・9度、北九州市小倉南区で零下3・3度など各地で今季最低を記録した。\\n福岡県警によ ると、福岡市内で7日夜から8日朝にかけて凍結した路面でのスリップ事故が相次いだ。博多区の県道交差点ではトラック3台による玉突き事故が発生。同市南区の市道では乗用車4台と軽乗用車1台が追突する玉突き事故があり、けが人が出た。福岡市消防局によると、雪による転倒などの119番通報は7日午後から8日午前9時までに50件あった。北九州市によると、午前10時までに男女14人が救急搬送されたことを確認。いずれも軽いけがだという。\\n九州北部の広い範囲で交通網が影響を受けた。西日本高速道路などによると、8日正午現在、大分道は全線で、九州道、東九州道、長崎道、西九州道などは一部で上下線が通行止め。福岡都市高速、北九州都市高速も7日深夜から通行止めが続いた。\",\"rate\":0.01,\"auto_paragraph\":true}"
- Response
{"detail": "bad parameters"}

ご注意・制限事項

  • 本APIは評価版となります。
  • 1APIキーに対して、1日20回までのご利用が許可されています。
  • 商用では利用できません。商用利用をご検討の際は、お問い合わせフォームよりご連絡をお願い致します。
  • 出力された要約は、必ずしも事実関係や文法が正しいわけではなく、破綻している場合もありますので、十分にご確認の上、ご利用ください。弊社は出力された内容に関して一切の責任を放棄致します。また、必ずしも意図した要約が出力されるわけではありません。
  • 文字数や圧縮率を指定された場合でも、必ずしもその指定が守られて出力されるわけではありません。
  • 入力する記事については、個人情報を含むものや、利用者または弊社が著作権を持つもの以外は送信しないでください。

以上について、詳しくは「利用規約」をご確認ください。

デモ

APIキー取得の上、下記のフォームで長文要約生成をお試しいただけます。

APIキー

要約の方法

パラグラフ分割:要約後の文章を、自動的に段落を判断し段落ごとに分割して返却します。(Experimental)

長さあるいは圧縮率を選択してください。

記事本文(100文字以上2000文字以下)

0文字
要約生成

結果は下記に表示されます。

  • 要約ボタンを押してください…