API는 오디오 및 비디오 파일에 대한 포괄적인 메타데이터를 반환하며, 주요 정보는 streams(스트림 정보)와 format(파일 포맷 정보) 필드에 포함되어 있습니다. 이 문서에서는 API 응답에 포함되는 각 필드에 대해 설명합니다.
오디오 및 비디오 스트림 정보 – streams 필드
각 미디어 스트림은 streams 배열의 하나의 항목에 해당합니다.
공통 필드
| 필드명 |
설명 |
| avg_frame_rate |
평균 프레임 레이트 |
| bit_rate |
비트레이트 |
| codec_long_name |
전체 코덱명 |
| codec_name |
코덱명 |
| codec_tag |
코덱 태그 |
| codec_tag_string |
코덱 태그 문자열 |
| codec_time_base |
코덱 프레임 시간 |
| codec_type |
코덱 타입 |
| display_aspect_ratio |
디스플레이 화면 비율 |
| disposition |
설정 정보 (아래 참조) |
| duration |
스트림 길이 |
| rotate |
회전 정보 |
| duration_ts |
전체 프레임 시간 |
| has_b_frames |
B-프레임 버퍼 크기 |
| height |
비디오 세로 해상도 |
| index |
스트림 인덱스 |
| level |
레벨 |
| nb_frames |
전체 프레임 수 |
| pix_fmt |
픽셀 포맷 |
| profile |
프로파일 |
| r_frame_rate |
실제 기준 프레임 레이트 |
| sample_aspect_ratio |
샘플 화면 비율 |
| start_pts |
시작 PTS(프리젠테이션 타임스탬프) |
| start_time |
첫 프레임 시간 |
| tag |
태그 정보 (아래 참조) |
| time_base |
프레임 단위 시간 |
| width |
비디오 가로 해상도 |
disposition 필드 설명
| 필드 |
설명 |
| attached_pic |
썸네일/첨부 이미지 |
| clean_effects |
클린 이펙트 |
| comment |
코멘트 |
| default |
기본 스트림 |
| dub |
더빙 |
| forced |
강제 스트림 |
| hearing_impaired |
청각장애용 스트림 |
| karaoke |
노래방 트랙 |
| lyrics |
가사 트랙 |
| original |
원본 스트림 |
| visual_impaired |
시각장애용 스트림 |
tag 필드 설명
| 필드 |
설명 |
| creation_time |
생성 시간 |
| encoder |
인코더 명 |
| handler_name |
핸들러 명 |
| language |
언어 |
오디오 스트림 전용 필드
| 필드명 |
설명 |
| bits_per_sample |
샘플당 비트수 |
| channels |
채널 수 |
| sample_fmt |
샘플 포맷 |
| sample_rate |
샘플 속도(Hz) |
파일 포맷 정보 – format 필드
이 필드는 전체 미디어 파일에 대한 정보를 포함합니다.
필드 설명
| 필드명 |
설명 |
| bit_rate |
비트레이트 |
| duration |
길이 |
| format_long_name |
전체 포맷명 |
| format_name |
포맷 약칭 |
| nb_programs |
프로그램 개수 |
| nb_streams |
스트림 개수 |
| probe_score |
프로브 점수(포맷 탐지 신뢰도) |
| size |
파일 크기 |
| start_time |
첫 프레임 시간 |
| tag |
태그 정보 (아래 참조) |
tag 필드 설명
| 필드 |
설명 |
| compatible_brands |
호환 브랜드 |
| creation_time |
생성 시간 |
| major_brand |
메인 브랜드 |
| minor_version |
마이너 버전 |
샘플 응답
{
"streams": [
{
"avg_frame_rate": <average frame rate>,
"bit_rate": <bitrate>,
"codec_long_name": <full codec name>,
"codec_name": <codec name>,
"codec_tag": <codec tag>,
"codec_tag_string": <codec tag string>,
"codec_time_base": <codec frame duration>,
"codec_type": <codec type>,
"display_aspect_ratio": <display aspect ratio>,
"disposition": { // disposition information
"attached_pic": 0,
"clean_effects": 0,
"comment": 0,
"default": 1,
"dub": 0,
"forced": 0,
"hearing_impaired": 0,
"karaoke": 0,
"lyrics": 0,
"original": 0,
"visual_impaired": 0
},
"duration": <duration>,
"rotate": <rotation information>,
"duration_ts": <total frame time>,
"has_b_frames": <B-frame buffer size>,
"height": <height>,
"index": <stream index>,
"level": <level>,
"nb_frames": <number of frames>,
"pix_fmt": <pixel format>,
"profile": <profile>,
"r_frame_rate": <real base frame rate>,
"sample_aspect_ratio": <sample aspect ratio>,
"start_pts": <start PTS>,
"start_time": <first frame time>,
"tag": { // tag information
"creation_time": <creation time>,
"encoder": <encoder name>,
"handler_name": <handler name>,
"language": <language>
},
"time_base": <frame duration>,
"width": <width>
},
{
"avg_frame_rate": <average frame rate>,
"bit_rate": <bitrate>,
"bits_per_sample": <bits per sample>,
"channels": <channels>,
"codec_long_name": <full codec name>,
"codec_name": <codec name>,
"codec_tag": <codec tag>,
"codec_tag_string": <codec tag string>,
"codec_time_base": <codec frame duration>,
"codec_type": <codec type>,
"disposition": { // disposition information
"attached_pic": 0,
"clean_effects": 0,
"comment": 0,
"default": 1,
"dub": 0,
"forced": 0,
"hearing_impaired": 0,
"karaoke": 0,
"lyrics": 0,
"original": 0,
"visual_impaired": 0
},
"duration": <duration>,
"duration_ts": <total frame time>,
"index": <stream index>,
"nb_frames": <number of frames>,
"profile": <profile>,
"r_frame_rate": <real base frame rate>,
"sample_fmt": <sample format>,
"sample_rate": <sample rate>,
"start_pts": <start PTS>,
"start_time": <first frame time>,
"tag": { // tag information
"creation_time": <creation time>,
"handler_name": <handler name>,
"language": <language>
},
"time_base": <frame duration>
}
],
"format": {
"bit_rate": <bitrate>,
"duration": <duration>,
"format_long_name": <full format name>,
"format_name": <format name>,
"nb_programs": <number of programs>,
"nb_streams": <number of streams>,
"probe_score": <probe score>,
"size": <file size>,
"start_time": <first frame time>,
"tag": { // tag information
"compatible_brands": <compatible brands>,
"creation_time": <creation time>,
"major_brand": <major brand>,
"minor_version": <minor version>
}
}
}