Ops Parameter Format

OPS는 네 가지 주요 카테고리의 파라미터를 제공합니다: 오디오/비디오 트랜스코딩, 오디오/비디오 합치기, 비디오 스크린샷, 앨범 아트 추출. 각 카테고리별 구체적인 파라미터는 아래에 자세히 안내되어 있습니다.

1. 오디오/비디오 트랜스코딩(avthumb)

예시: 소스 파일을 오디오 비트레이트 64k, 비디오 비트레이트 128k의 FLV 포맷으로 변환합니다.

avthumb/flv/ab/64k/vb/128k|saveas/YnVja2V0OmtleQ==

파라미터	필수 여부	설명
<op>	예	avthumb (작업 유형: 오디오/비디오 처리)
<format>	예	출력 대상 포맷. 지원되는 포맷에는 mp4, flv, m3u8, mpd 등이 있습니다.

---

오디오 트랜스코딩 파라미터

파라미터	필수 여부	설명
/acodec/<AudioCodec>	아니오	오디오 코덱. 지원되는 코덱: libmp3lame, libfaac, libvorbis, libfdk_aac, opus 등. 원본 오디오 코덱을 유지하려면 copy 파라미터도 지원합니다.
/ab/<BitRate>	아니오	오디오 비트레이트, 단위: 비트/초(bit/s). 일반 값: 64k, 128k, 192k, 256k, 320k 등.
/ar/<SamplingRate>	아니오	오디오 샘플링 속도, 단위: 헤르츠(Hz). 일반 값: 8000, 12050, 22050, 44100 등. 참고: FLV 포맷은 44100, 22050, 11025만 지원됩니다.
/aq/<AudioQuality>	아니오	오디오 품질. MP3: 0-9 범위(값이 낮을수록 더 높은 품질). AAC: 10-500 범위(값이 높을수록 더 높은 품질). MP3 및 AAC에만 적용 가능. /ab/와 함께 사용할 수 없습니다.
/ac/<AC>	아니오	오디오 채널 수. 모노는 1, 스테레오는 2입니다.
/aprofile/<AudioProfile>	아니오	오디오 압축 프로파일. libfaac: aac_main, aac_low; libfdk_aac: aac_low, aac_he, aac_he_v2. 기본값: aac_lc.
/volume/<volumeadjustment>	아니오	오디오 볼륨 조정. 배수 또는 데시벨(dB) 조정 지원: - 배수: 0-2 범위(0은 음소거, 1은 원본, 2는 두 배, 1.5는 1.5배). - 데시벨: -10dB ~ 10dB 권장. 음수는 감소, 양수는 증가. 과도한 값은 왜곡이 발생할 수 있음.
/loudnorm/<VolumeNormalization>	아니오	라우드니스 정규화 대상 설정(단위: LUFS). 범위: -70 ~ -5. 값이 클수록(더 큰 음수) 오디오가 더 조용해집니다. 참고사항: - 출력 오디오 코덱이 eac3일 경우, /ar/는 48000, 44100, 32000이어야 합니다. - 출력 오디오 코덱이 ac3일 경우, /ar/는 48000 또는 44100이어야 합니다. - DTS 인코딩은 지원되지 않습니다. - /volume/와 동시에 사용하지 않는 것이 좋습니다.
/write_id3v2/<write_id3v2>	아니오	AAC 트랜스코딩 시 소스에서 ID3v2 프레임을 쓸지 여부. 1이면 기록, 0 또는 미설정 시 미기록.
|saveas/<Encode(bucket:filekey)>	아니요	트랜스코딩된 출력을 지정된 파일에 저장합니다. 값은 URL 안전 Base64로 인코딩된 bucket:key 문자열입니다.

---

비디오 트랜스코딩 매개변수

매개변수	필수	설명
/vcodec/<VideoCodec>	아니요	비디오 코덱입니다. 지원 코덱: libx264, libws265(H.265/HEVC), libvpx, libtheora, libxvid 등. 소스 비디오 코덱을 유지하려면 copy도 지원합니다. 참고: /vcodec/에 해상도를 지정하는 경우 /vb/(비트레이트)도 반드시 설정해야 합니다. 설정하지 않으면 원본 인코딩이 사용됩니다.
/s/<Resolution>	아니요	비디오 해상도를 widthxheight(예: 640x480) 또는 적응형 모드로 설정합니다: - 너비와 높이 모두 설정: 정확한 크기로 스케일링합니다. 비율이 다를 경우, 왜곡 또는 압축이 발생할 수 있습니다. - 너비 또는 높이만 설정(예: 1280x-1, -1x720): 다른 한쪽 값은 비율을 유지하면서 자동으로 조정됩니다.
/autoscale/<Autoscale>	아니요	/s/와 함께 사용됩니다. 1로 설정 시 화면 비율을 유지한 채 /s/ 직사각형 내에 영상을 맞춥니다(비율이 다를 경우 검은 테두리가 생길 수 있음). 0 또는 기본값은 화면 크기에 맞게 영상을 늘립니다.
/autofill/<Autofill>	아니요	/s/와 함께 사용됩니다. 1로 설정 시 화면 비율을 유지하고 비디오를 중앙에 배치하며, 여백에는 검은색 바가 삽입됩니다. 0 또는 기본값은 화면에 맞게 영상을 늘립니다. 예시: 소스 1920x1920, 대상 /s/1280x720. - autofill=1: 실제 비디오 내용은 1280x720에서 중앙에 위치한 720x720이며 나머지는 검은색 바가 채워집니다.
/sar/<Sar>	아니요	픽셀 종횡비(Pixel Aspect Ratio), 예: 1:1. 해상도보다 우선 적용됩니다. 예시: /s/720x720과 /sar/1:2 를 함께 사용하면 720x1440 출력이 생성됩니다.
/vb/<VideoBitRate>	아니요	비디오 비트레이트(bit/s)입니다. 예시: 128k, 1.25m, 5m.
/vbRatio/<vbRatio>	아니요	출력 비디오 비트레이트는 입력 비트레이트에 이 계수를 곱한 값입니다. 범위: (0, 15]. 참고사항: - 0 또는 15를 초과할 경우 실패합니다. - 결과가 50 Mbps를 초과할 경우 해당 파라미터는 무시됩니다. - /vb/와 /vbRatio/가 모두 설정되면 /vbRatio/가 우선 적용됩니다.
/r/<FrameRate>	아니요	비디오 프레임 레이트(Hz). 일반 값: 24, 25, 30. 기본값은 소스 값입니다.
/calcMD5/<calcMD5>	아니요	1로 설정 시 헤더에 MD5 해시 포함(MP4만 해당), 0(기본값)은 비활성화.
/calcFrameRate/<calcFrameRate>	아니요	1로 설정 시 수동 계산 및 frame_rate 포함(FLV 프레임 레이트가 변경될 때 유용).
/lowfps_check/<lowfps_check>	아니요	1로 설정 시 저 프레임 레이트 소스 영상 지원. 입력 FPS가 10 미만이면 출력이 10 fps로 설정됩니다. 기본값은 0입니다.
/force_key_frames/<force_key_frames>	아니요	지정된 타임스탬프(초 단위)에 키프레임을 삽입합니다. 예: 1.1,2.3,4.2. 값은 정렬되어야 하며 쉼표로 구분된 실수여야 합니다.
/rotate/<Degree>	아니요	시계 방향 회전: 90, 180, 270, auto. 기본값은 회전 없음입니다.
/vprofile/<VideoProfile>	아니요	비디오 압축 프로파일: baseline, main, high, high10, high422, high444. 높은 프로파일일수록 더 진보된 압축 기능을 제공합니다.
/pix_fmt/<PixelFormat>	아니요	픽셀 포맷을 설정합니다. 예: yuv420p, yuv422p, yuv444p. yuv420p(YUV 4:2:0)은 웹 비디오 스트리밍에서 가장 많이 사용되는 포맷으로, 호환성과 압축 효율이 뛰어납니다.
/level/<BitTorrentLevel>	아니요	H.264 레벨, 1.0–5.1. 호환성에 사용(오직 libx264에만 적용).
/crf/<CRF>	아니요	품질 인코딩을 위한 고정 비트율(Constant Rate Factor, CRF) 설정(libx264에만 적용). 범위: 0–51. 값이 높을수록 화질이 낮아집니다. 권장 범위: [18, 28]. 참고: 최적의 화질과 비트율 제어를 위해 /maxrate/, /crf/, /bufsize/를 함께 설정하는 것이 좋습니다.
/maxrate/<Maxrate>	아니요	VBR(가변 비트레이트) 인코딩의 최대 비트레이트(예: 1000k). /bufsize/와 함께 사용해야 합니다.
/bufsize/<Bufsize>	아니요	디코더 버퍼 크기, /maxrate/와 함께 사용(예: 1000k).
/dup_lastframe_sec/<dup_lastframe_sec>	아니요	마지막 프레임을 연장할 초 단위 시간입니다. 예시: /dup_lastframe_sec/15는 마지막 프레임을 15초간 연장합니다.
/GOPInterval/<GOPInterval>	아니요	키프레임 간격(밀리초 단위)입니다. 설정하지 않으면 자동 알고리즘이 지정합니다. g(단위: 프레임)와는 함께 사용할 수 없습니다.
/StrictGOPInterval/<StrictGOPInterval>	아니요	엄격한 키프레임 간격(밀리초 단위)을 강제합니다. - < 0인 경우 오류입니다. - > 0이면 지정된 간격을 적용합니다. - = 0이면 모든 프레임을 I-프레임으로 설정합니다. 이 설정을 사용하면 /GOPInterval/ 및 -g보다 우선 적용됩니다.
/deinterlace/<Deinterlace>	아니오	디인터레이스 제어: - 0: 디인터레이스 없음(기본값; 출력은 항상 프로그레시브). - 1: 강제 적용; 항상 실행. - 2: 표준 적용; 입력이 인터레이스일 경우만 실행. - 3: 고급(FFmpeg 내부); 인터레이스 입력일 경우만 실행.
/stripmeta/<StripMeta>	아니오	1은 파일 메타데이터를 제거하고, 0은 보존합니다.
/seiKeep/<seiKeep>	아니오	1은 트랜스코딩 중 SEI 메시지를 보존하고, 0(기본값)은 보존하지 않습니다. 리멕싱 시에는 항상 SEI가 유지됩니다.
/delogo/<x:y:w:h,x:y:w:h...>	아니오	지정한 사각형 영역에 블러를 적용합니다(로고 제거 용도). 형식: x:y:w:h. 여러 영역은 콤마(,)로 구분합니다.
/reverse/<reverse>	아니오	1은 재생을 반대로(역방향) 전환하고, 0(기본값)은 정상 재생입니다. 오디오/비디오의 역재생은 5분 이내 미디어만 지원됩니다.
/speedup/<speedup>	아니오	재생 속도를 조정합니다. 느리게의 범위: [0.1,1), 빠르게의 범위: (1,10]. 값 1은 정상 속도입니다. 소수점 값도 허용됩니다.
|saveas/<Encode(bucket:filekey)>	아니오	트랜스코딩된 결과물을 지정한 파일에 저장합니다(URL-safe Base64로 인코딩됨).

---

리먹싱 및 오디오/비디오 세그먼트 파라미터

파라미터	필수	설명
/pat_period/<pat_period>	아니오	PAT/PMT 주기를 초 단위로 설정합니다. 소수점 입력 지원(예: 0.23, 5.6).
/pcr_every_packet/<pcr_every_packet>	아니오	1로 설정 시 pcr_packet_period를 1로 하여 모든 패킷에 PCR을 포함합니다. 기본값: 비활성화.
/rename_by_key/<RenameByM3U8>	아니오	1로 설정 시 세그먼트 이름으로 기본 M3U8 파일명을 사용합니다. 0(기본값)은 비활성화. avconcat 및 avthumb에서 M3U8 출력에 적용됩니다.
/pes_payload_size/<pes_payload_size>	아니오	최소 PES 페이로드 크기를 설정합니다. 0으로 설정하면 패킷당 AAC 프레임이 하나로 보장됩니다. 기본값: 비활성화.
/dash_hls_playlist/<dash_hls_playlist>	아니오	1로 설정 시 MPD와 함께 M3U8 파일도 생성됩니다. 기본값: 0(MPD만 생성). 포맷이 mpd일 때만 적용.
/enable_mp4_hvc1/<enable_mp4_hvc1>	아니오	H.265 비디오의 경우, 1로 설정하면 비디오 트랙의 stsd 태그가 hvc1로 설정됩니다(기본값: hev1). 기본값: 비활성화.
/segtype/<segtype>	아니요	DASH용 세그먼트 포맷: mp4 또는 m4s. 기본값: m4s.
/segtime/<SegSeconds>	아니요	세그먼트 지속 시간을 초 단위로 설정합니다. 정수: 1–120. 기본 동작: - 입력이 M3U8/MPD가 아닐 경우: 10초. - 입력이 트랜스코딩 없는 M3U8/MPD일 경우: 인덱스만 처리됩니다. - 입력이 트랜스코딩이 적용된 M3U8/MPD일 경우: 자동 계산됩니다.
/fastStartSeg/<FastStartSeg>	아니요	초기 M개의 세그먼트의 지속 시간을 설정합니다. 형식: MxNs (예: 5x3s는 처음 5개의 세그먼트가 각각 3초임을 의미).
/map/<map>	아니요	입력 스트림 매핑: - map=0: 모든 스트림 - map=0:a: 모든 오디오 스트림 - map=0:a:0: 첫 번째 오디오 - map=0:a:lang=chi: 언어 라벨.
/an/<AudioNo>	아니요	1은 오디오 스트림을 제거하고, 0은 보존합니다(기본값).
/vn/<VideoNo>	아니요	1은 비디오 스트림을 제거하고, 0은 보존합니다(기본값).
/moovToFront/<MoovToFront>	아니요	1은 MP4 moov atom을 파일의 시작 지점으로 이동시키고, 0은 이동하지 않습니다.
/stripmeta/<StripMeta>	아니요	1은 파일 메타데이터를 제거하고, 0은 보존합니다(기본값).
/preset/<Preset>	아니요	HLS Preset 이름. 아래 표를 참조하세요.
|saveas/<Encode(bucket:filekey)>	아니요	출력 파일을 저장하며, URL-safe Base64로 인코딩됩니다.

/preset/용 HLS 프리셋:

카테고리	프리셋 이름	설명
오디오	audio_32k	32k 비트레이트의 오디오
	audio_48k	48k 비트레이트의 오디오
	audio_64k	64k 비트레이트의 오디오
비디오	video_16x9_150k	150K 비트레이트, 16:9, 400x224 해상도
	video_16x9_240k	240K 비트레이트, 16:9, 400x224 해상도
	video_16x9_440k	440K 비트레이트, 16:9, 400x224 해상도
	video_16x9_640k	640K 비트레이트, 16:9, 400x224 해상도
	video_4x3_150k	150K 비트레이트, 4:3, 400x300 해상도
	video_4x3_240k	240K 비트레이트, 4:3, 400x300 해상도
	video_4x3_440k	440K 비트레이트, 4:3, 400x300 해상도
	video_4x3_640k	640K 비트레이트, 4:3, 400x300 해상도
	video_150k	150K 비트레이트, 원본 비율 유지
	video_240k	240K 비트레이트, 원본 비율 유지
	video_440k	440K 비트레이트, 원본 비율 유지
	video_640k	640K 비트레이트, 원본 비율 유지
	video_1000k	1000K 비트레이트, 원본 화면비 유지
	video_1500k	1500K 비트레이트, 원본 화면비 유지

---

HLS/DASH 적응형 비트레이트 파라미터

매개변수	필수 여부	설명
/envBandWidth/<EnvBandWidth>	아니오	M3U8 스트림 전환용 대역폭 임계값(b/s). 콜론(:)으로 구분. 범위: [2,10] 값. 각 값: (50000, 30000000]. 예시: 60000:150000:500000. 수량은 /multiAb/, /multiVb/ 등과 반드시 일치해야 합니다. DASH에는 사용할 수 없습니다.
/multiAb/<MultiAb>	아니요	여러 오디오 비트레이트를 콜론(:)으로 구분해 지정합니다(예: 64k:128k:256k). 값의 범위는 [2,10]개입니다. /ab/와 함께 사용할 수 없습니다. M3U8 시나리오에서는 개수가 일치해야 합니다.
/multiVb/<MultiVb>	아니요	여러 비디오 비트레이트를 콜론(:)으로 구분해 지정합니다(예: 128k:600k:1.25m). /vb/와 함께 사용할 수 없습니다. M3U8의 경우 개수가 일치해야 합니다.
/multiResolution/<MultiResolution>	아니요	여러 비디오 해상도를 콜론(:)으로 구분해 지정합니다(예: 320x240:640x480:1080x720). /s/와 함께 사용할 수 없습니다. ax-1 또는 -1xa 옵션을 통해 가변 스케일링이 허용됩니다. M3U8의 경우 해상도 개수가 일치해야 합니다.
/dash_hls_playlist/<dash_hls_playlist>	아니요	1 설정 시 MPD 외에 M3U8 파일도 생성되어 가변 비트레이트(Adaptive Bitrate)를 지원합니다. 기본값은 0이며, 출력 포맷이 mpd일 때만 적용됩니다.
|saveas/<Encode(bucket:filekey)>	아니요	트랜스코딩 출력물을 저장하며, URL-safe Base64로 인코딩됩니다.

---

비디오 클리핑 파라미터

매개변수	필수 여부	설명
/ss/<SeekStart>	아니요	동영상 구간 추출의 시작 시간(초 단위)입니다.
/t/<Duration>	아니요	추출된 동영상 구간의 길이(초 단위)입니다.
|saveas/<Encode(bucket:filekey)>	아니요	클립 출력물을 URL-안전 Base64로 인코딩하여 저장합니다.

---

동영상 크롭 매개변수

매개변수	필수 여부	설명
/vcrop/<Vcrop>	아니오	영상 크롭의 크기와 오프셋을 설정합니다. 기본값: 크롭 없음. 아래 섹션을 참조하세요.
/gravity/<Gravity>	아니오	크롭의 기준점/원점을 설정합니다. 기본값: TOP_LEFT. 아래 옵션을 참고하세요.
|saveas/<Encode(bucket:filekey)>	아니오	크롭된 결과를 URL-safe Base64로 인코딩하여 저장합니다.

/vcrop/의 비디오 크롭 작업 값:

형식	설명
<Width>x	너비만 설정; 높이는 변경되지 않음 (너비: 0-10000).
!{vcropSize}a<dx>a<dy>	기준점(anchor)에서 오른쪽으로 dx만큼, 아래쪽으로 dy만큼 오프셋 (원 시스템에서 명확히 확인 필요).
x<Height>	높이만 설정; 너비는 변경되지 않음 (높이: 0-10000).
<Width>x<Height>	너비와 높이를 명시적으로 설정 (0–10000).

/gravity/에 대한 Gravity 옵션:

값	설명
TOP_LEFT	기준점: 좌상단. X: 왼쪽→오른쪽, Y: 위→아래.
TOP_CENTER	원점 상단 중앙. X: 왼쪽→오른쪽, Y: 위→아래.
TOP_RIGHT	원점 우상단. X: 오른쪽→왼쪽, Y: 위→아래.
CENTER_LEFT	원점 좌측 중앙. X: 왼쪽→오른쪽, Y: 위→아래.
CENTER	중심점. X: 왼쪽→오른쪽, Y: 위→아래.
CENTER_RIGHT	원점 우측 중앙. X: 오른쪽→왼쪽, Y: 위→아래.
BOTTOM_LEFT	원점 좌하단. X: 왼쪽→오른쪽, Y: 아래→위.
BOTTOM_CENTER	원점 하단 중앙. X: 왼쪽→오른쪽, Y: 아래→위.
BOTTOM_RIGHT	원점 우하단. X: 오른쪽→왼쪽, Y: 아래→위.

---

자막 파라미터

매개변수	필수 여부	설명
/subtitle/<EncodedPath1[,EncodedPath2...]>	예	자막 파일. 각 경로는 URL-세이프 Base64로 인코딩된 문자열이며, 여러 파일의 경우 콤마로 구분합니다. SRT, 내장형 MKV 또는 embed 옵션을 지원합니다.
/subtitleType/<subtitleType>	아니오	1은 소프트 자막, 2는 하드 자막, 0(기본값)은 자동 감지입니다.
/subtitleAttr/<EncodedAttr1[,EncodedAttr2...]>	아니오	다중 비트레이트 M3U8에서 VTT용 자막 속성. 형식: base64_encode(lang=xx1,name=yy1),base64_encode(lang=xx2,name=yy2). 수량은 자막 파일 수와 일치해야 합니다.
|saveas/<Encode(bucket:filekey)>	아니오	자막이 내장되거나 첨부된 상태로 결과물을 저장하며, URL-세이프 Base64로 인코딩됩니다.

---

워터마크 파라미터 (이미지/비디오 워터마크)

파라미터	필수 여부	설명
/wmImage2/<EncodedPath1[,EncodedPath2...]>	아니요	이미지/비디오 워터마크 경로. URL-safe Base64로 인코딩하고 쉼표로 구분합니다.
/wmGravity/<Gravity1[,Gravity2...]>	아니요	워터마크 위치를 설정합니다. /gravity/와 동일한 옵션을 사용하세요. 여러 위치는 쉼표로 구분합니다.
/wmauto/<wmauto>	아니요	1로 설정하면 워터마크가 영상 해상도에 맞춰 자동으로 크기가 조정됩니다. 그렇지 않으면 원본 크기가 사용됩니다.
/wmWidth/<WmWidth1[,WmWidth2...]>	아니요	워터마크 너비(px 또는 백분율, 예: 40 또는 50%)를 지정합니다. 0 또는 음수인 경우 해당 방향의 자동 크기 조정이 적용됩니다.
/wmHeight/<WmHeight1[,WmHeight2...]>	아니오	워터마크 높이. /wmWidth/와 동일한 옵션이 적용됩니다.
/wmDissolve/<alpha1[,alpha2...]>	아니오	워터마크 불투명도. 범위 [0,100]. 기본값: 100(완전 불투명).
/wmdx/<dx1[,dx2...]>	아니오	기준점(anchor)으로부터의 수평 오프셋(px)입니다. 양수: 오른쪽, 음수: 왼쪽. /wmGravity/ 개수와 일치해야 합니다.
/wmdy/<dy1[,dy2...]>	아니오	기준점(anchor)으로부터의 수직 오프셋(px)입니다. 양수: 아래, 음수: 위. /wmGravity/ 개수와 일치해야 합니다.
/wmInterval/<wmInterval>	아니오	워터마크 변경을 위한 시간 간격(초)입니다.

---

워터마크 파라미터 (텍스트 워터마크)

파라미터	필수	설명
/wmText/<EncodedText1[,EncodedText2...]>	아니오	워터마크 텍스트, 각각 URL 안전 Base64로 인코딩됨. 텍스트 내 쉼표 지원. 한글/중국어는 UTF-8로 인코딩.
/wmFont/<EncodedFontNames>	아니오	글꼴 이름. 쉼표로 구분 후 URL 안전 Base64로 인코딩됨. 영문, 숫자, 공백, 하이픈만 허용.
/wmFontColor/<EncodedColors>	아니오	글꼴 색상. 쉼표로 구분 후 URL 안전 Base64로 인코딩됨. 형식: 0xRRGGBB, &HRRGGBB 또는 16진수. 기본값: 0xffffff.
/wmFontSize/<size1[,size2...]>	아니오	글꼴 크기. 정수 또는 높이의 백분율(예: 10 또는 10%). 픽셀: [5,2160]; 백분율: (0,100%]. 기본값: 6%.
/wmFontDissolve/<alpha1[,alpha2...]>	아니오	투명도. 범위 [0,100], 기본값 100.
/wmFontBorderWidth/<w1[,w2...]>	아니오	글꼴 테두리 두께. 정수; <=0이면 테두리 없음(기본값 0).
/wmFontBorderColor/<EncodedBorderColors>	아니오	테두리 색상, /wmFontColor/와 동일하게 인코딩됨. 기본값: 0x000000.
/wmTextGravity/<gravity1[,gravity2...]>	아니오	텍스트 워터마크 위치. /wmGravity/와 동일. 기본값: top_right.
/wmtextdx/<dx1[,dx2...]>	아니요	텍스트 앵커 기준의 수평 오프셋(px, 기본값: 0).
/wmtextdy/<dy1[,dy2...]>	아니요	텍스트 앵커 기준의 수직 오프셋(px, 기본값: 0).
/wmTextInterval/<interval1[,interval2...]>	아니요	텍스트 워터마크 전환 간격(초 단위, 1 이상).
/wmFontBold/<b1[,b2...]>	아니요	0이 아니면 글꼴이 굵게 표시됩니다(기본값 0).
|saveas/<Encode(bucket:filekey)>	아니요	워터마크가 적용된 출력 결과를 URL-safe Base64로 인코딩하여 저장합니다.

---

LBHD 파라미터

매개변수	필수 여부	설명
/nbhd/<nbhd>	아니오	1은 인공지능 기반의 지능형 고화질 인코딩을 활성화하고, 0은 비활성화합니다(기본값).
|saveas/<Encode(bucket:filekey)>	아니오	출력 파일을 저장하며, URL-safe Base64로 인코딩됩니다.

---

HLS 표준 암호화 매개변수

매개변수	필수 여부	설명
/hlsKey/<HlsKey>	아니요	AES-128 암호화 키입니다. 반드시 OAEP로 RSA 암호화한 후 ASCII 16진수로 변환 후 URL-safe Base64 인코딩해야 합니다.
/hlsKeyUrl/<HlsKeyUrl>	아니요	HLS 키를 가져오는 URL로, URL-safe Base64로 인코딩하여 M3U8의 #EXT-X-KEY 태그에 삽입합니다.
/hlskeygen/<hlskeygen>	아니요	키 파일 생성/업로드 시 1, 생성하지 않을 경우(기본값) 0을 입력합니다.
/hlssk/<hlssk>	아니요	RSA 개인키 파일(PEM), URL-safe Base64로 인코딩됨.
|saveas/<Encode(bucket:filekey)>	아니요	암호화된 출력 파일을 URL-safe Base64로 인코딩하여 저장합니다.

---

2. 오디오/비디오 병합(avconcat)

예시: fileA, fileB, fileC를 하나의 FLV 파일로 합칩니다.

avconcat/flv/ZmlsZUE=/ZmlsZUI=/ZmlsZUM=|saveas/YnVja2V0OmtleQ==

여기서 ZmlsZUE=, ZmlsZUI=, ZmlsZUM=는 파일 fileA, fileB, fileC에 대해 URL-safe Base64로 인코딩된 bucket:key 입니다.

매개변수	필수 여부	설명
<op>	예	avconcat (작업 유형: 오디오/비디오 병합)
<format>	예	출력 대상 포맷, 예: mp4, flv, m3u8.
/<EncodedUrl1>/<EncodedUrl2>/.../<EncodedUrlN>	예	병합할 파일. 각각은 URL-safe Base64로 인코딩되어야 하며, 모두 동일한 버킷에 속해야 합니다. 최대: 5개. 참고: 트랜스코딩 파라미터와 함께 사용할 수 있습니다.
|saveas/<Encode(bucket:filekey)>	아니오	결과물을 파일로 저장합니다. 파일명은 URL-safe Base64로 인코딩됩니다.

---

3. 비디오 스크린샷 (vframe)

예시: 10초 지점에서 스크린샷을 캡처하여 JPG 파일로 저장합니다.

vframe/jpg/offset/10|saveas/YnVja2V0OmtleQ==

매개변수	필수 여부	설명
<op>	예	vframe (Operation type: Video Screenshot)
<format>	예	출력 이미지 형식: jpg, png, gif, webp 등
/mode/<mode>	아니오	썸네일 크기 조정: - 1: 최소 지정된 너비/높이, 센터에서 크기 조정/잘라내기. - 2: 최대 지정된 크기까지 비율에 따라 크기 조정. - 3: 최소 지정된 크기, 비율 유지를 위해 초과 가능, 크기만 조정.
/offset/<Second>	예*	캡처할 시간(초)입니다. 여러 번 캡처 시 /interval/, /offsets/, 또는 /vframeN/와 함께 사용할 경우 필수가 아닙니다. format이 gif이고 /t/ 옵션과 함께 사용하면, GIF의 시작 시간을 지정합니다.
/offsets/<vframeList>	아니오	지정된 초에 여러 스크린샷을 캡처합니다. 콜론으로 구분(예: 1:3:10:20). 출력은 이미지가 담긴 ZIP 파일입니다.
/interval/<Interval>	아니오	지정한 간격(초)마다 스크린샷을 캡처. 출력은 ZIP.
/vframeN/<vframeN>	아니오	캡처할 스크린샷 개수. 출력은 ZIP.
/w/<width>	아니오	픽셀 단위의 너비(1–1920).
/h/<height>	아니오	픽셀 단위의 높이(1–1080).
/autofill/<autofill>	아니오	/w/ 및 /h/와 함께 사용 시, 1로 설정하면 화면 비율을 유지하며 검은색 여백이 생깁니다. /mode/와는 함께 사용할 수 없습니다. 너비와 높이 모두 필수입니다.
/isZip/<isZip>	아니오	다중 스크린샷의 ZIP 파일 출력 여부(기본값: 압축됨). 압축을 해제하려면 0으로 설정하세요.
/sprite/<sprite>	아니오	스프라이트 시트의 행렬 크기(예: 4x5). /interval/ 옵션 필요. 출력은 스프라이트 이미지이며, 프레임이 많을 경우 여러 개 생성됩니다.
/rotate/<degree>	아니오	시계 방향 회전: 90, 180, 270, auto. 기본값: 회전 없음.
/reverse/<reverse>	아니오	1은 프레임 순서를 역순(여기서는 GIF 용도), 0은 정상 순서입니다.
/t/<Duration>	아니오	GIF 캡처 지속 시간(기본값: 5초).
/r/<FrameRate>	아니오	GIF의 프레임 속도(기본값: 소스 기준).
/gif_interval/<Gif_interval>	아니오	GIF 루프 간격(기본값: 2초).
/speedup/<speedup>	아니오	재생 속도입니다. <1은 느려지고, >1은 빨라집니다.
|saveas/<Encode(bucket:filekey)>	아니오	출력 이미지 또는 ZIP을 URL-안전 Base64로 인코딩하여 저장합니다.

---

4. 앨범 아트 가져오기(getapic)

예시: 오디오 파일에서 앨범 아트를 추출하여 JPG로 저장합니다.

getapic/jpg|saveas/YnVja2V0OmtleQ==

매개변수	필수 여부	설명
<op>	예	getapic (작업 유형: MP3 앨범 아트 추출)
<format>	예	출력 이미지 포맷: jpg, png 등
|saveas/<Encode(bucket:filekey)>	아니오	추출된 이미지를 URL-safe Base64로 인코딩하여 저장합니다.

---

부록

1. 지원되는 폰트 형식

폰트 패밀리	파라미터 값(폰트명)	저작권 정보
Noto Sans CJK SC	Noto Sans CJK SC Regular	이는 고객 플랫폼의 법적 고지 섹션에 추가할 수 있습니다. 예시: — 비디오 워터마크 등 기능의 경우, Noto Sans SC 및 Noto Serif 폰트의 저작권자는 Google입니다. 사용은 OFL(SIL Open Font License)에 따라 허가되어 있습니다. OFL 전문은 다음에서 확인 가능합니다: https://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&id=OFL
	Noto Sans CJK SC Black	(위와 동일)
	Noto Sans CJK SC Bold	(위와 동일)
	Noto Sans CJK SC DemiLight	(위와 동일)
	Noto Sans CJK SC Light	(위와 동일)
	Noto Sans CJK SC Medium	(위와 동일)
	Noto Sans CJK SC Thin	(위와 동일)
Noto Sans Mono CJK SC	Noto Sans Mono CJK SC Regular	(위와 동일)
	Noto Sans Mono CJK SC Bold	(위와 동일)
Noto Serif CJK SC	Noto Serif CJK SC	(위와 동일)
	Noto Serif CJK SC Black	(위와 동일)
	Noto Serif CJK SC ExtraLight	(위와 동일)
	Noto Serif CJK SC Light	(위와 동일)
	Noto Serif CJK SC Medium	(위와 동일)
	Noto Serif CJK SC SemiBold	(위와 동일)
Roboto	Roboto	이 내용은 고객 플랫폼의 법률(legal) 섹션에 추가할 수 있습니다. 예시: — Video Watermark와 같은 기능의 경우, Roboto 폰트의 저작권자는 Google입니다. 아파치 라이선스 2.0 버전에 따라 사용이 허가되었습니다. 라이선스 전문은 다음에서 확인하실 수 있습니다: http://www.apache.org/licenses/LICENSE-2.0.txt
	Roboto Condensed	(위와 동일)
	Roboto Condensed Light	(위와 동일)
	Roboto Black	(위와 동일)
	Roboto Light	(위와 동일)
	Roboto Medium	(위와 동일)
	Roboto Thin	(위와 동일)
WenQuanYi Zen Hei Mono	WenQuanYi Zen Hei Mono	고객 플랫폼의 법적 고지 섹션에 추가할 수 있습니다. 내용 예시: — Video Watermark 등 기능의 경우, WenQuanYi 폰트의 저작권자는 FangQ 및 "WenQuanYi Board of Trustees"입니다. 사용은 GNU General Public License(GPL) 하에 허가되었으며, GPL 전문은 다음에서 확인할 수 있습니다: http://wenq.org/wqy2/index.cgi?GPL
WenQuanYi Zen Hei Sharp	WenQuanYi Zen Hei Sharp	(위와 동일)
WenQuanYi Zen Hei	WenQuanYi Zen Hei	(위와 동일)