다큐멘트 센터 Object Storage API Simple Audio/Video Metadata (avinfo2)

Simple Audio/Video Metadata (avinfo2)

최신 업데이트:2025-08-18 15:32:29

이 API는 CDNetworks 오브젝트 스토리지 플랫폼에 저장된 특정 오디오 및 비디오 리소스의 기본 메타데이터를 조회하는 데 사용됩니다.

요청 설명

GET /<key>?op=avinfo2
HOST: <DownloadDomain>

헤더 설명

파라미터 필수 여부 설명
Host 버킷에 할당된 다운로드 도메인

파라미터 설명

파라미터 필수 여부 설명
op 동작 타입. 반드시 avinfo2(간략 오디오·비디오 정보)여야 함

응답 설명

성공 응답

요청이 성공하면 아래 예시와 같은 JSON 객체가 반환됩니다.

{
    "streams": [
        {
            "index": 0,
            "codec_name": "h264",
            "codec_type": "video",
            "width": 480,
            "height": 480,
            "pix_fmt": "yuv420p",
            "duration": "246.633333",
            "bit_rate": "1173144",
            "nb_frames": "7399",
            "rotate": "90"
        },
        {
            "index": 1,
            "codec_name": "aac",
            "codec_type": "audio",
            "sample_rate": "44100",
            "channels": 2,
            "duration": "246.595918",
            "bit_rate": "122396",
            "nb_frames": "10620"
        }
    ],
    "format": {
        "nb_streams": 2,
        "format_name": "mov,mp4,m4a,3gp,3g2,mj2",
        "duration": "246.639000",
        "size": "40149865",
        "bit_rate": "1302330"
    }
}

필드별 상세 설명은 avinfo 필드 설명을 참고하세요.

참고: rotate 필드는 선택 사항이며, 비디오 스트림에 회전 정보가 있는 경우에만 나타납니다.

실패 응답

요청이 실패하면 아래와 같은 형식의 JSON 객체가 반환됩니다.

{
    "code": "<code string>",
    "message": "<message string>"
}
필드명 필수 여부 설명
code HTTP 응답 코드. HTTP 응답 상태 코드 참고
message 간략 오디오·비디오 정보 조회 실패 사유를 알려주는 에러 메시지

요청 예시

curl -v "http://downloadDomain/1.mp4?op=avinfo2"
이 문서의 내용이 도움이 되었습니까?
아니오
정상적으로 제출되었습니다.피드백을 주셔서 감사합니다.앞으로도 개선을 위해 노력하겠습니다.