要約
    • PDF

    要約

    • PDF

    記事の要約

    Classic/VPC環境で利用できます。

    さまざまなオプションを適用して長文を要約します。

    リクエスト

    リクエスト形式を説明します。リクエスト形式は次の通りです。

    メソッドURI
    POST/testapp/v1/api-tools/summarization/v2/{appId}

    リクエストヘッダ

    リクエストヘッダの説明は次の通りです。

    フィールド必須の有無説明
    X-NCP-CLOVASTUDIO-API-KEYRequiredテストアプリやサービスアプリの作成時に発行された API Key
    X-NCP-APIGW-API-KEYRequiredテストアプリやサービスアプリの作成時に発行された API Gateway Key
    X-NCP-CLOVASTUDIO-REQUEST-IDOptionalリクエスト ID
    Content-TypeRequiredリクエストデータの形式
    • application/json

    リクエストパスパラメータ

    リクエストパスパラメータの説明は次の通りです。

    フィールドタイプ必須の有無説明
    appIdStringRequiredテストアプリまたはサービスアプリの ID

    リクエストボディ

    リクエストボディの説明は次の通りです。

    フィールドタイプ必須の有無説明
    textsArrayRequired要約対象の文書
    • 1~35,000文字(ハングル基準、スペースを含む)
    autoSentenceSplitterBooleanOptional要約対象文章の段落分けを許可するかどうか
    • true(デフォルト) | false
      • true: 段落分けとsegCountsegMaxSizesegMinSizeを適用
      • false: 段落分けしない
    segCountIntegerOptional要約対象文章の段落分け数
    • -1(デフォルト) | 1以上
      • -1: モデルが最適値で自動実行
    segMaxSizeIntegerOptional段落分け後段落の最大文字数
    • 1~3,000文字(ハングル基準、スペースを含む) (デフォルト: 1,000)
    segMinSizeIntegerOptional段落分け後段落の最小文字数
    • 0~segMaxSizeの値(デフォルト: 300)
    includeAiFiltersBooleanOptionalAIフィルタを適用するかどうか
    • true | false(デフォルト)
      • true: 適用
      • false: 適用しない

    リクエスト例

    リクエストのサンプルコードは次の通りです。

    curl --location --request POST 'https://clovastudio.apigw.ntruss.com/testapp/v1/api-tools/summarization/v2/{appId}' \
    --header 'X-NCP-CLOVASTUDIO-API-KEY: {CLOVA Studio API Key}' \
    --header 'X-NCP-APIGW-API-KEY: {API Gateway API Key}' \
    --header 'X-NCP-CLOVASTUDIO-REQUEST-ID: {Request ID}' \
    --header 'Content-Type: application/json' \
    --data '{
                "texts": [
                    「CLOVA Studioが提供するさまざまな機能は次の通りです。- 文章生成: いくつかのキーワードを入力するだけで、そのキーワードをもとにシナリオ作成、自己紹介書作成、メール作成、マーケティングのキャッチコピー作成などさまざまな分野の文章を生成。- 要約: あらすじ、レポート、メールなど、長文から主要な要素を把握して設定した要約文の長さに合わせて文章を要約。- 分類: 文章のタイプ、文書のインデックス、感情、意図などの特徴を分類したり、段落から主要なキーワードを抽出可能。- 会話: 例を入力すると固有のペルソナを持つ AIを生成し、百科事典型チャットボット、カスタムチャットボットなどの会話インターフェースを作成可能。- 文章変換: 入力した例と似たスタイルの文章に文章の形を変換可能な AI Filter: 要注意か安全でない結果が生成されることを検知して通知する AI Filter機能を提供"
                ],
                "autoSentenceSplitter": true,
                "segCount": -1,
                "segMaxSize": 1000,
                "segMinSize": 300,
                "includeAiFilters": false
    }'
    

    レスポンス

    レスポンス形式を説明します。

    レスポンスボディ

    レスポンスボディの説明は次の通りです。

    フィールドタイプ必須の有無説明
    textString-要約結果
    inputTokensInteger-要約対象文章のトークン数

    レスポンス例

    レスポンスのサンプルコードは次の通りです。

    成功

    呼び出しに成功した場合のレスポンスのサンプルコードは次の通りです。

    {
        "status": {
            "code": "20000",
            "message": "OK"
        },
        "result": {
            "text": "- CLOVA Studioが提供するさまざまな機能を説明している",
            "inputTokens": 187
        }
    }
    

    失敗

    呼び出しに失敗した場合のレスポンスのサンプルコードは次の通りです。


    この記事は役に立ちましたか?

    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.