어두운 영상을 밝게 만드는 방법: 노출, 감마, 레벨

어두운 영상을 밝게 하려면 필터로 노출이나 감마를 올리고 다시 인코딩하세요. FFmpeg에서 exposure=exposure=0.5는 노출을 반 스톱 올리고, eq=gamma=1.3은 감마를 기본값 1에서 올립니다. Sume에서는 이미 media.sume.com에 호스팅된 클립과 이 필터를 filtergraph로 POST /v1/video-filter에 보내면, 소리는 그대로이고 더 밝아진 새 MP4를 돌려받습니다.

필터 옵션은 FFmpeg 필터 문서를, Sume 관련 내용은 영상 필터 문서와 Sume API 레퍼런스를 따르며, 모두 2026-09-27에 확인했습니다. Sume가 어떤 필터를 받고 어떻게 인코딩하는지는 Sume의 필터 컴파일러에서 확인한 것으로, 현재 동작을 설명합니다.

어떤 필터로 어두운 영상을 밝게 하나요?

아래 표의 네 필터는 모두 현재 Sume의 필터 허용 목록에 있습니다. 표의 값은 조정을 시작할 출발점이며, colorlevels 줄만 FFmpeg 문서에 실린 예시입니다.

• 필터는 한 그래프 안에서 쉼표로 이어 붙입니다. 예를 들면 exposure=exposure=0.3,eq=gamma=1.1이며, 이름 있는 필터 최대 32개, 최대 2,048자까지 쓸 수 있습니다.
• 어떤 설정이 알맞아 보일지는 촬영본에 따라 다릅니다. 매번 클립 전체를 인코딩하지 않고 몇 가지를 비교하려면 영상 트림으로 짧은 구간을 잘라 먼저 거기에 필터를 적용하세요.

Sume API로 영상을 밝게 하려면 어떻게 하나요?

클립과 필터를 Idempotency-Key와 함께 POST /v1/video-filter로 보내세요. 클립은 이전 Sume Job의 출력처럼 이미 워크스페이스에 있는 media.sume.com 아티팩트나 에셋이어야 하며, 이 규칙은 엔드포인트별로 받는 URL에서 설명합니다.

• POST /v1/video-filter/check는 같은 본문으로 인코딩과 같은 스키마, 허용 목록, 소스 검사를 무료로 실행하며, Job을 만들지 않고 크레딧도 예약하지 않습니다. 인코더는 실행하지 않으므로, 검사를 통과한 프로그램도 잘못된 식 같은 이유로 워커에서 실패할 수 있으며, 그 경우 Job 오류로 돌아옵니다.
• 기본 mode는 async입니다. GET /v1/jobs/:id/status를 폴링한 다음 GET /v1/jobs/:id/result로 새 video_url을 받으세요. 출력은 소스의 크기, 프레임 레이트, 오디오를 유지하며, 소스는 그대로 남습니다. 출력의 인코딩 방식은 필터 허용 목록 글에 정리되어 있습니다.

curl -X POST https://api.sume.com/v1/video-filter \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: brighten-001" \
  -d '{
    "video_url": "https://media.sume.com/artifacts/artf_demo/dark-clip.mp4",
    "filtergraph": "eq=gamma=1.3"
  }'

영상을 덜 밝게 하려면 어떻게 하나요?

필터에 내장된 dim op를 쓰세요. 예를 들면 "ops": [{ "op": "dim", "amount": 0.7 }]입니다. amount는 0보다 크고 1 이하여야 하므로 이 op는 어둡게만 만들며, 색을 바꾸지 않고 검은색은 검은색으로 유지합니다. 이 op는 트림, 필터, 오디오 분리에서 다룹니다. filtergraph에 음수 exposure 값을 넣어도 어두워집니다.

한도는 어떻게 되나요?

• 필터는 파일에 있는 픽셀의 레벨을 바꿉니다. 카메라가 완전한 검은색으로 기록한 부분에는 되살릴 디테일이 없습니다.
• Job당 클립 하나, 최대 300초이며, 더 긴 소스는 output_duration_exceeded로 실패합니다.
• 필터는 HDR 소스(PQ 또는 HLG)를 hdr_source_unsupported로 거부합니다. 과금되지 않는 POST /v1/video-inspect 프로브를 쓰면 제출하기 전에 hdr 값을 알 수 있습니다.
• 검사는 무료이고 인코딩은 Job당 과금되며, 문서는 요율을 GET /v1/catalog에서 확인하라고 안내합니다. 밝기가 아니라 색 틀어짐을 바로잡으려면 영상 색보정 방법을 참고하세요.