인덱스 목록 조회

VPC 환경에서 이용 가능합니다.

미디어 에셋의 인덱스 목록을 조회합니다.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드	URI
GET	/api/v1/workspaces/{workspace_name}/projects/{project_id}/assets/{asset_id}/indexes

요청 헤더

Media Intelligence API에서 공통으로 사용하는 헤더에 대한 정보는 Media Intelligence 요청 헤더를 참조해 주십시오.

요청 경로 파라미터

요청 경로 파라미터에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`workspace_name`	String	Required	워크스페이스 이름
`project_id`	String	Required	프로젝트 ID 프로젝트 목록 조회 참조
`asset_id`	String	Required	미디어 에셋 ID 미디어 에셋 목록 조회 참조

요청 예시

요청 예시는 다음과 같습니다.

curl --location --request GET 'https://mi.apigw.ntruss.com/api/v1/workspaces/my-workspace/projects/1234/assets/5678/indexes' \
--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'

응답

응답 형식을 설명합니다.

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`code`	String	-	API 처리 결과 코드
`message`	String	-	API 처리 결과 메시지
`result.totalCount`	Integer	-	전체 인덱스 수
`result.indexes`	Array	-	인덱스 객체 목록: indexes

`indexes`

indexes에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`indexId`	Integer	-	인덱스 ID
`type`	String	-	에셋 타입 `IMAGE` \| `VIDEO` `IMAGE`: 이미지 `VIDEO`: 비디오
`createdTime`	String	-	인덱스 생성 일시 ISO 8601 형식
`createdUserName`	String	-	인덱스를 생성한 사용자 이름
`updatedTime`	String	-	인덱스 최종 수정 일시 ISO 8601 형식
`updatedUserName`	String	-	인덱스를 마지막으로 수정한 사용자 이름
`analysisSetting`	Object	-	분석 설정 정보
`analysisSetting.analysisEngine`	String	-	분석 엔진 버전 `Sinossi v1.0`
`analysisSetting.sceneRange`	String	-	(영상 분석 시) 자동으로 분할되는 장면의 길이 `SHORT` \| `MEDIUM` (기본값) \| `LONG` `SHORT`(짧게): 짧은 단위로 세밀하게 분할하여 영상 내 세부 장면을 정밀하게 분석 `MEDIUM`(보통): 장면 간 적절한 흐름을 유지하면서 주요 변화 포착 `LONG`(길게): 장면 간 연결성을 높여 자연스러운 흐름 유지 이미지 에셋은 null로 표시
`analysisSetting.analysisPersonCount`	Integer	-	분석 시 감지할 인물의 수
`analysisSetting.analysisLanguage`	String	-	분석 시 기준이 되는 언어 이 필드는 향후 제거될 예정 (대체 필드: `sourceLanguage`)
`analysisSetting.sourceLanguage`	String	-	분석 대상 원본 파일의 언어 정보 `ENKO` (기본값) \| `EN` \| `KO` \| `JA` \| `ZH-CN` \| `ZH-TW` `ENKO`: 한국어 + 영어 `EN`: 영어 `KO`: 한국어 `JA`: 일본어 `ZH-CN`: 중국어 (간체) `ZH-TW`: 중국어 (번체)
`analysisSetting.detectAudioEffects`	Boolean	-	(영상 분석 시) 분석 시 설정한 음성 효과 추가 여부 `true`│`false` (기본값)

응답 상태 코드

Media Intelligence API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Media Intelligence 응답 상태 코드를 참조해 주십시오.

응답 예시

응답 예시는 다음과 같습니다.

{
    "code": "0",
    "message": "success",
    "result": {
        "totalCount": 2,
        "indexes": [
            {
                "indexId": 1001,
                "type": "VIDEO",
                "createdTime": "2025-04-24T10:10:47",
                "createdUserName": "username",
                "updatedTime": "2025-04-24T10:12:52",
                "updatedUserName": "username",
                "analysisSetting": {
                    "analysisEngine": "Sinossi v1.0",
                    "sceneRange": "LONG",
                    "analysisPersonCount": 6,
                    "analysisLanguage": "ENKO",
                    "sourceLanguage": "ENKO",
                    "detectAudioEffects": true
                }
            },
            {
                "indexId": 1002,
                "type": "IMAGE",
                "createdTime": "2025-04-24T10:31:08",
                "createdUserName": "username",
                "updatedTime": "2025-04-24T10:33:11",
                "updatedUserName": "username",
                "analysisSetting": {
                    "analysisEngine": "Sinossi v1.0",
                    "sceneRange": null,
                    "analysisPersonCount": 8,
                    "analysisLanguage": "EN",
                    "sourceLanguage": "EN",
                    "detectAudioEffects": false
                }
            }
        ]
    }
}