感情分析
    • PDF

    感情分析

    • PDF

    記事の要約

    感情分析 API

    テキストデータを分析して当該単語、文章、フレーズに込められた感情を分析するサービスであり、その結果を返す HTTPベース REST APIです。

    リクエスト

    POST https://naveropenapi.apigw.ntruss.com/sentiment-analysis/v1/analyze
    

    リクエストヘッダ

    ヘッダ名説明
    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

    リクエストボディ

    フィールド名要否タイプ説明
    contentYesString感情分析 Text
    config.negativeClassificationNoBoolean否定構文分析オプション

    レスポンス

    レスポンスボディ

    フィールド名データタイプ説明
    documentObject文章全体関連 object
    document.sentimentString文章全体における感情
    document.confidenceObject文章全体における感情 confidence
    document.confidence.neutralFloat中立 confidence(%)
    document.confidence.positiveFloat肯定 confidence(%)
    document.confidence.negativeFloat否定 confidence(%)
    sentencesList of Object分類文章関連 list object
    sentences.contentString分類文章
    sentences.offsetIntdocument.contentにおける文の開始位置
    sentences.lengthInt分類文章の文字数
    sentences.sentimentString分類文章の感情
    sentences.confidenceObject分類文章に対する感情 confidence
    sentences.confidence.neutralFloat中立 confidence(%)
    sentences.confidence.positiveFloat肯定 confidence(%)
    sentences.confidence.negativeFloat否定 confidence(%)
    sentences.highlightsList of Objectsentences.contentにおける感情分析区間
    sentences.highlights.offsetInt主な感情区間の開始位置
    sentences.highlights.lengthInt主な感情区間の文字数
    sentences.negativeSentiment.sentimentString否定感情の場合、細部感情
    sentences.negativeSentiment.confidenceFloat否定感情の場合、細部感情に対する confidence

    リクエスト例

    {
      "content": "ヒヤリとする。短刀が飛んできて胸に突き刺さる。"
    }
    

    レスポンス例

    {
        "document": {
            "sentiment": "negative",
            "confidence": {
                "neutral": 0.14525136640572725,
                "positive": 0.00186876227013191,
                "negative": 0.8528798713241407
            }
        },
        "sentences": [
            {
                "content": "ヒヤリとする。",
                "offset": 0,
                "length": 5,
                "sentiment": "negative",
                "confidence": {
                    "negative": 0.9961358904838562,
                    "positive": 0.0036366574931889772,
                    "neutral": 0.0002274021098855883
                },
                "highlights": [
                    {
                        "offset": 0,
                        "length": 4
                    }
                ]
            },
            {
                "content": " 短刀が飛んできて胸に突き刺さる。",
                "offset": 5,
                "length": 17,
                "sentiment": "negative",
                "confidence": {
                    "negative": 0.927976131439209,
                    "positive": 0.07131962478160858,
                    "neutral": 0.0007042606011964381
                },
                "highlights": [
                    {
                        "offset": 1,
                        "length": 15
                    }
                ]
            }
        ]
    }
    
    

    エラー

    エラー例

    {
      "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文章が基準値を超えた場合
    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.