장면 요약 결과 조회

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

장면 요약이 완료된 인덱스의 결과 데이터를 조회합니다. 응답에는 인덱스 레벨의 장면 요약 정보와 각 장면별 요약 결과가 포함됩니다.

참고

장면 요약 상태가 SUMMARIZE_COMPLETED인 경우에만 결과 조회가 가능합니다. 장면 요약이 완료되지 않은 상태에서 요청 시 에러가 반환됩니다.

요청

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

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

요청 헤더

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

요청 경로 파라미터

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

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

요청 예시

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

curl --location --request GET 'https://mi.apigw.ntruss.com/api/v1/workspaces/my-workspace/projects/1234/assets/5678/indexes/1001/scene-summaries' \
--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`	Object	-	장면 요약 결과 정보
`result.indexId`	Integer	-	인덱스 ID
`result.sceneSummaryInfo`	Object	-	장면 요약 정보 장면 요약이 완료된 경우에만 존재
`result.sceneSummaryInfo.lastAnalyzedAt`	String	-	마지막 장면 요약 실행 완료 일시 ISO 8601 형식
`result.sceneSummaryInfo.analyzedSceneIds`	Array<String>	-	마지막 분석에 포함된 장면 ID 목록 전체 분석인 경우 `null`
`result.sceneSummaries`	Array	-	장면별 요약 결과 목록: sceneSummaries

`sceneSummaries`

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

필드	타입	필수 여부	설명
`scene`	Integer	-	장면 번호
`startMs`	Integer	-	장면 시작 시간(밀리초)
`endMs`	Integer	-	장면 종료 시간(밀리초)
`sceneSummary`	Object	-	장면 요약 정보 해당 장면이 분석된 경우에만 존재
`sceneSummary.description`	String	-	장면 요약 설명 4~6문장의 자연어 요약 발화자의 주요 발언은 큰따옴표로 표기 등장인물의 주요 행동 및 장면 내 키워드 포함
`sceneSummary.metadataChangedAfterSummary`	Boolean	-	장면 요약 생성 이후 해당 장면에 영향을 줄 수 있는 메타데이터(인물 라벨, 스크립트 등)가 변경되었는지 여부 재분석 필요 판단 용도
`sceneSummary.analyzedAt`	String	-	해당 장면의 장면 요약 완료 일시 ISO 8601 형식

응답 상태 코드

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

응답 예시

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

{
    "code": "0",
    "message": "success",
    "result": {
        "indexId": 1001,
        "sceneSummaryInfo": {
            "lastAnalyzedAt": "2026-04-17T10:30:00",
            "analyzedSceneIds": null
        },
        "sceneSummaries": [
            {
                "scene": 1,
                "startMs": 1000,
                "endMs": 3000,
                "sceneSummary": {
                    "description": "진행자가 서울 광화문 광장에서 카메라를 향해 인사하며 오늘의 인터뷰 주제를 소개한다. 진행자는 \"오늘은 시민들의 일상 이야기를 들어보겠습니다\"라고 말하며 거리로 이동한다.",
                    "metadataChangedAfterSummary": false,
                    "analyzedAt": "2026-04-17T10:30:00"
                }
            }
        ]
    }
}