--- title: "화질 설정 조회" slug: "media-livestation-qualitysetting-qualitysettinginfo" tags: ["Quality Setting", "Live Station"] updated: 2026-09-17T09:16:48Z published: 2026-09-17T09:16:48Z canonical: "api.ncloud-docs.com/media-livestation-qualitysetting-qualitysettinginfo" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # 화질 설정 조회 Classic/VPC 환경에서 이용 가능합니다. 전체(System, Custom) 화질 설정의 상세 정보를 조회합니다. ## 요청 요청 형식을 설명합니다. 요청 형식은 다음과 같습니다. | 메서드 | URI | | --- | --- | | GET | /api/v2/qualitySets/{qualitySetId} | ### 요청 헤더 Live Station API에서 공통으로 사용하는 헤더에 대한 정보는 [Live Station 요청 헤더](/docs/media-livestation#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)를 참조해 주십시오. ### 요청 경로 파라미터 요청 경로 파라미터에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `qualitySetId` | Integer | Required | 화질 설정 아이디 - [화질 설정 목록 조회](/docs/media-livestation-qualitysetting-qualitysettinglist) 참조 | ### 요청 예시 요청 예시는 다음과 같습니다. ``` curl --location --request GET 'https://livestation.apigw.ntruss.com/api/v2/qualitySets/****' \ --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' \ --header 'x-ncp-region_code: KR' ``` ## 응답 응답 형식을 설명합니다. ### 응답 바디 응답 바디에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `content` | Object | - | 화질 설정 정보 | | `content.disabled` | Boolean | - | 화질 비활성화 여부 - `true` \| `false` - `true`: 비활성 - `false`: 활성 | | `content.id` | Integer | - | 화질 설정 아이디 | | `content.status` | String | - | 화질 설정 상태 - `CREATED`: 생성 완료 (유효 값) | | `content.createdTime` | Integer | - | 화질 설정 생성 일시(밀리초) - Unix Timestamp 형식 | | `content.genType` | String | - | 설정 분류 - `CUSTOM` \| `SYSTEM` - `CUSTOM`: 직접 생성 - `SYSTEM`: 기본 제공 | | `content.name` | String | - | 화질 설정 이름 | | `content.segmentDuration` | Integer | - | 세그먼트당 재생 시간(밀리초) - 세그먼트 재생 시간이 길수록 파일 크기가 커지고 로딩 시간 증가 가능성 존재 - 세그먼트 재생 시간이 짧을수록 파일 크기는 작아지나 버퍼링 발생 가능성 존재 - `isEnabledUll`이 `false`인 경우, 표시 | | `content.segmentCount` | Integer | - | 세그먼트 수 - 세그먼트 수가 많을수록 재생 안정성 증가하나 지연 가능성과 메모리 사용량도 증가 - 세그먼트 수가 적을수록 지연 가능성 감소하나 재생 안정성 및 타임머신 재생 범위도 감소 - `isEnabledUll`이 `false`인 경우, 표시 | | `content.qualities` | Array | - | 화질 목록: [qualities](/docs/media-livestation-qualitysetting-qualitysettinginfo#qualities) | | `content.inUseChannelNames` | Array | - | 사용 중인 채널 목록 - 사용 중인 채널이 없는 경우, 빈 값 `[]` 표시 | | `content.enableHlsTimedMetadata` | Boolean | - | 시간 기반 메타데이터 설정 여부 - `true` \| `false` - `true`: 설정 - `false`: 설정 안 함 | | `content.isEnabledUll` | Boolean | - | Low Latency 설정 여부 - `true` \| `false` - `true`: LL-HLS (CMAF을 이용한 저지연 HLS 스트리밍을 위한 옵션) - `false`: HLS (안정적이고 호환성 높은 HLS 스트리밍을 이용하기 위한 옵션) | | `content.targetLatency` | Integer | - | Low Latency 목표 지연 시간(초) - `isEnabledUll`이 `true`인 경우, 표시 | | `content.timedMetadata` | Object | - | 시간 기반 메타데이터 설정 - `enableHlsTimedMetadata`가 `true`인 경우, 표시 | | `content.timedMetadata.key` | String | - | 키 - `utc` (유효 값) | | `content.timedMetadata.header` | String | - | 헤더(식별 값) | | `content.timedMetadata.interval` | Integer | - | 삽입 주기(밀리초) - `1000` (유효 값) | #### `qualities` `qualities`에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `disabled` | Boolean | - | 화질 비활성화 여부 - `true` \| `false` - `true`: 비활성 - `false`: 활성 | | `id` | Integer | - | 화질 아이디 | | `status` | String | - | 화질 상태 - `CREATED`: 생성 완료 (유효 값) | | `createdTime` | Integer | - | 화질 생성 일시(밀리초) - Unix Timestamp 형식 | | `genType` | String | - | 설정 분류 - `CUSTOM` \| `SYSTEM` - `CUSTOM`: 직접 생성 - `SYSTEM`: 기본 제공 | | `name` | String | - | 화질 이름 | | `type` | String | - | 화질 타입 - `NORMAL` \| `AUDIO` \| `BYPASS` - `NORMAL`: 비디오, 오디오 출력 - `AUDIO`: 오디오 전용 출력 - `BYPASS`: 원본 출력 설정에 따름 | | `video` | Object | - | 비디오 설정 정보 - `type`이 `AUDIO`인 경우, 하위 정보 포함하여 미표시 | | `video.fps` | Float | - | 초당 프레임 수(fps) | | `video.bitrate` | Integer | - | 비디오 스트림의 비트레이트(bps) | | `video.bframes` | Integer | - | B-프레임(양방향 예측 프레임) 수 | | `video.level` | Integer | - | 비디오 코덱 레벨 - `-1`: AUTO (유효 값) - 재생(디코딩)에 필요한 하드웨어의 성능 한계치를 미리 정의해 둔 표준 명세 | | `video.width` | Integer | - | 출력 비디오의 너비(픽셀) | | `video.height` | Integer | - | 출력 비디오의 높이(픽셀) | | `video.bypass` | Boolean | - | 비디오 스트림 바이패스 여부 - `true` \| `false` - `true`: 원본 스트림 그대로 사용(pass-through) - `false`: 설정 정보에 맞춰 트랜스코딩 | | `video.codec` | String | - | 비디오 코덱 포맷 - `H264` (유효 값) | | `video.orientation` | String | - | 비디오 방향 전환 설정 - `FIX` \| `FREE` - `FIX`: 고정 - `FREE`: 전환 가능 | | `video.profile` | String | - | 비디오 코덱 프로필 - `BASELINE` \| `MAIN` \| `HIGH` - `BASELINE`: 기본 옵션(저사양 단말용, 최소 기능 제공) - `MAIN`: HD 권장 옵션 - `HIGH`: Full HD 권장 옵션 - 비디오의 사용 용도에 맞게 H.264 코덱의 특정 기술을 사용할 수 있도록 미리 정의해 둔 표준 명세 | | `video.rateControl` | String | - | 비트레이트 배분 방식 - `VBR` \| `CBR` - `VBR`: 가변 비트레이트(Variable Bitrate) - `CBR`: 고정 비트레이트(Constant Bitrate) | | `video.videoH264ParamRefFrames` | Integer | - | H.264 참조 프레임 수 - `1` (유효 값) | | `audio` | Object | - | 오디오 설정 정보 | | `audio.codec` | String | - | 오디오 코덱 포맷 - `AAC` \| `MP3` | | `audio.profile` | String | - | 오디오 코덱 프로필 - `LC`: AAC-LC (유효 값) | | `audio.samplerate` | Integer | - | 오디오 샘플링 레이트(Hz) - 초당 샘플링 수 | | `audio.channels` | Integer | - | 오디오 채널 수 | | `audio.bitrate` | Integer | - | 오디오 스트림의 비트레이트(Kbps) | | `audio.bypass` | Boolean | - | 오디오 스트림 바이패스 여부 - `true` \| `false` - `true`: 원본 스트림 그대로 사용(pass-through) - `false`: 설정 정보에 맞춰 트랜스코딩 | ### 응답 상태 코드 Live Station API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 [Live Station 응답 상태 코드](/docs/media-livestation#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)를 참조해 주십시오. ### 응답 예시 응답 예시는 다음과 같습니다. ``` { "content": { "disabled": false, "id": ****, "status": "CREATED", "createdTime": 1755138264000, "genType": "CUSTOM", "name": "setting000", "segmentDuration": 1000, "segmentCount": 2, "qualities": [ { "disabled": false, "id": 5, "status": "CREATED", "createdTime": 1546300800000, "genType": "SYSTEM", "name": "720p-9-16", "type": "NORMAL", "video": { "fps": 30.0, "bitrate": 2500000, "bframes": 0, "level": -1, "width": 720, "height": 1280, "bypass": false, "codec": "H264", "profile": "MAIN", "rateControl": "VBR", "videoH264ParamRefFrames": 1 }, "audio": { "codec": "AAC", "profile": "LC", "samplerate": 48000, "channels": 0, "bitrate": 128, "bypass": false } }, { "disabled": false, "id": ****, "status": "CREATED", "createdTime": 1755134604000, "genType": "CUSTOM", "name": "quality000", "type": "NORMAL", "video": { "fps": 60.0, "bitrate": 204800000, "bframes": 4, "level": -1, "width": 1920, "height": 1080, "bypass": true, "codec": "H264", "profile": "HIGH", "rateControl": "VBR", "videoH264ParamRefFrames": 1 }, "audio": { "codec": "AAC", "profile": "LC", "samplerate": 44100, "channels": 2, "bitrate": 320, "bypass": true } } ], "inUseChannelNames": [ "channel000" ], "enableHlsTimedMetadata": true, "isEnabledUll": false, "timedMetadata": { "key": "utc", "header": "ncloud.livestation.metadata", "interval": 1000 } } } ```