Get index details

Prev Next

Available in VPC

Get details of indices for a video asset.

Request

Method URI
GET /api/v1/workspaces/{workspace_name}/projects/{project_id}/video-assets/{video_asset_id}/indexes/{index_id}

Request headers

For information about the headers common to all Media AI Understanding APIs, see Media AI Understanding request headers.

Request path parameters

The following describes the parameters.

Field Type Required Description
workspace_name String Required Workspace name
project_id String Required Project ID
video_asset_id String Required Video asset ID
index_id String Required Index ID

Request query parameters

You can use the following query parameters with your request:

Field Type Required Description
confidence_level String Optional Filtering criteria based on confidence
  • LOW | MEDIUM (default) | HIGH
    • LOW: Display low confidence detection results (extract more keywords).
    • MEDIUM: Display medium confidence detection results (moderate keyword extraction).
    • HIGH: Display high confidence detection results (accurate keyword extraction).

Request example

The request example is as follows:

curl --location --request GET 'https://maiu.apigw.ntruss.com/api/v1/workspaces/my-workspace/projects/1234/video-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'

Response

This section describes the response format.

Response body

The response body includes the following data:

Field Type Required Description
code String Required API processing result code
message String Required API processing result message
result Object Required Index details
result.indexId Integer Required Index ID
result.createdTime String Required Index creation date and time
  • ISO 8601 format
result.createdUserName String Required User name that created the index
result.updatedTime String Required Last index modification date and time
  • ISO 8601 format
result.updatedUserName String Required User name who last edited the index
result.analysisSetting Object Required Analysis configuration information
result.analysisSetting.analysisEngine String Required Analysis engine version
  • Sinossi v1.0
result.analysisSetting.sceneRange String Required Length of automatically split scenes
  • SHORT | MEDIUM (default) | LONG
    • SHORT: Analyze detailed scenes in the video with second-by-second segmentation.
    • MEDIUM: Capture key changes while maintaining proper flow between scenes.
    • LONG: Maintain a natural flow by enhancing connectivity between scenes.
result.analysisSetting.analysisPersonCount Integer Required Number of people to detect when analyzing video
result.analysisSetting.analysisLanguage String Required Language of reference for video analysis
  • En-Ko
result.indexDetails Object Required Index content information
result.indexDetails.durationMs Integer Required Video length (millisecond)
result.indexDetails.fps Integer Required Number of frames per second
result.indexDetails.frameCount Integer Required Total frame count
result.indexDetails.videoUrl String Required Video source URL
result.indexDetails.segments Array Required Segment list

result.indexDetails.segments

Field Type Required Description
start Integer Required Segment start frame number
  • Start from 0.
end Integer Required Segment end frame number
startMs Integer Required Segment start time (millisecond)
endMs Integer Required Segment end time (millisecond)
scene Integer Required Scene number
shot Integer Required Shot number
speeches Array Required Utterance information
keywords Array Required Keyword information
people Array Required Character information

result.indexDetails.segments.speeches

Field Type Required Description
id Integer Optional Utterance ID
startMs Integer Optional Utterance start time (millisecond)
endMs Integer Optional Utterance end time (millisecond)
text String Optional Utterance content
pid String Optional Person ID
name String Optional Person name

result.indexDetails.segments.keywords

Field Type Required Description
category String Optional Keyword category
group String Optional Keyword group
text String Optional Keyword text
score Integer Optional Keyword confidence score

result.indexDetails.segments.people

Field Type Required Description
name String Optional Person name
pid String Optional Person ID
img String Optional Image URL

Response status codes

For information about the HTTP status codes common to all Media AI Understanding APIs, see Media AI Understanding response status codes.

Response example

The response example is as follows:

{
    "code": "0",
    "message": "success",
    "result": {
        "indexId": 1001,
        "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": "En-Ko"
        },
        "indexDetails": {
            "durationMs": 20054,
            "fps": 29.97,
            "frameCount": 601,
            "videoUrl": "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,
                    "speeches": [
                        {
                            "id": 180080,
                            "startMs": 679,
                            "endMs": 10195,
                            "text": "Hello, thank you for joining us today for this interview.",
                            "pid": "1",
                            "name": "Speaker 1"
                        }
                    ],
                    "keywords": [
                        {
                            "category": "Behavior",
                            "group": "Business, office, event",
                            "text": "News anchor",
                            "score": 87.23
                        },
                        {
                            "category": "Video production technique",
                            "group": "Shooting technique",
                            "text": "Interview",
                            "score": 85.12
                        }
                    ],
                    "people": []
                },
                {
                    "start": 275,
                    "end": 467,
                    "startMs": 9176,
                    "endMs": 15583,
                    "scene": 2,
                    "shot": 2,
                    "speeches": [
                        {
                            "id": 180081,
                            "startMs": 10195,
                            "endMs": 20000,
                            "text": "Thank you for inviting me in. It's a pleasure to meet you."
                            "pid": "2",
                            "name": "Speaker 2"
                        }
                    ],
                    "keywords": [
                        {
                            "category": "Location",
                            "group": "Commercial facility",
                            "text": "Broadcast studio",
                            "score": 80.26
                        }
                    ],
                    "people": [
                        {
                            "name": "Person 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,
                    "speeches": [],
                    "keywords": [
                        {
                            "category": "Object",
                            "group": "Fashion",
                            "text": "Wristwatch",
                            "score": 85.81
                        }
                    ],
                    "people": [
                        {
                            "name": "Person 1",
                            "pid": "1234567890123456789",
                            "img": "https://kr.object.ncloudstorage.com/maiu-my-storage/indexer/1001/people/1234567890123456789.jpg"
                        }
                    ]
                }
            ]
        }
    }
}