インデックスの詳細照会

VPC環境で利用できます。

メディアアセットのインデックスの詳細情報を照会します。

リクエスト

リクエストヘッダ

Media Intelligence APIで共通して使用されるヘッダの詳細は、Media Intelligenceのリクエストヘッダをご参照ください。

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

パラメータの説明は次の通りです。

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

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

リクエスト例

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

curl --location --request GET 'https://mi.apigw.ntruss.com/api/v1/workspaces/my-workspace/projects/1234/assets/5678/indexes/1001?confidence_level=MEDIUM' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Content-Type: application/json'

レスポンス

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

レスポンスボディ

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

result.indexDetails.segments

result.indexDetails.segments.speeches

result.indexDetails.segments.keywords

result.indexDetails.segments.people

レスポンスステータスコード

Media Intelligence APIで共通して使用されるレスポンスステータスコードの詳細は、Media Intelligenceのレスポンスステータスコードをご参照ください。

レスポンス例

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

{
    "code": "0",
    "message": "success",
    "result": {
        "indexId": 1001,
        "type": "VIDEO",
        "createdTime": "2025-04-24T16:42:00",
        "createdUserName": "username",
        "updatedTime": "2025-04-24T16:43:08",
        "updatedUserName": "username",
        "analysisSetting": {
            "analysisEngine": "Sinossi v1.0",
            "sceneRange": "MEDIUM",
            "analysisPersonCount": 2,
            "analysisLanguage": "ENKO"
            "sourceLanguage": "ENKO",
            "detectAudioEffects": true    
        },
        "indexDetails": {
            "durationMs": 20054,
            "fps": 29.97,
            "frameCount": 601,
            "assetUrl": "https://kr.object.ncloudstorage.com/maiu-my-storage/videos/1234/interview.mp4",
            "segments": [
                {
                    "start": 0,
                    "end": 275,
                    "startMs": 0,
                    "endMs": 9176,
                    "scene": 1,
                    "shot": 1,
                    "sceneThumbnailUrl": "https://kr.object.ncloudstorage.com/.../1234/1.jpg?X-Amz-..."
                    "speeches": [
                        {
                            "id": 180080,
                            "startMs": 679,
                            "endMs": 10195,
                            "text": "こんにちは。本日はインタビューにご協力いただき、ありがとうございます。",
                            "pid": "1",
                            "name": "話者1"
                        }
                    ],
                    "keywords": [
                        {
                            "category": "行動",
                            "group": "事務/オーフィス/イベント",
                            "text": "ニュースキャスター",
                            "score": 87.23
                        },
                        {
                            "category": "ビデオ制作技法",
                            "group": "撮影技法",
                            "text": "インタビュー",
                            "score": 85.12
                        }
                    ],
                    "people": []
                },
                {
                    "start": 275,
                    "end": 467,
                    "startMs": 9176,
                    "endMs": 15583,
                    "scene": 2,
                    "shot": 2,
                    "sceneThumbnailUrl": "https://kr.object.ncloudstorage.com/.../1234/2.jpg?X-Amz-..."
                    "speeches": [
                        {
                            "id": 180081,
                            "startMs": 10195,
                            "endMs": 20000,
                            "text": "お招きいただきありがとうございます。お会いできて嬉しいです。"
                            "pid": "2",
                            "name": "話者2"
                        }
                    ],
                    "keywords": [
                        {
                            "category": "場所",
                            "group": "商業施設",
                            "text": "放送スタジオ",
                            "score": 80.26
                        }
                    ],
                    "people": [
                        {
                            "name": "人物2",
                            "pid": "9876543210987654321",
                            "img": "https://kr.object.ncloudstorage.com/maiu-my-storage/indexer/1001/people/9876543210987654321.jpg?"
                        }
                    ]
                },
                {
                    "start": 467,
                    "end": 601,
                    "startMs": 15583,
                    "endMs": 20054,
                    "scene": 2,
                    "shot": 3,
                    "sceneThumbnailUrl": "https://kr.object.ncloudstorage.com/.../12345/2.jpg?X-Amz-..."
                    "speeches": [],
                    "keywords": [
                        {
                            "category": "オブジェクト",
                            "group": "ファッション",
                            "text": "腕時計",
                            "score": 85.81
                        }
                    ],
                    "people": [
                        {
                            "name": "人物1",
                            "pid": "1234567890123456789",
                            "img": "https://kr.object.ncloudstorage.com/maiu-my-storage/indexer/1001/people/1234567890123456789.jpg"
                        }
                    ]
                }
            ]
        }
    }
}