2026-09-26미디어 도구

영상 편집 API 한도: Sume 미디어 도구 상한을 표 하나로 정리

Sume의 트림, 필터, 오디오 분리, 프레임, 검사, 자막, Timeline API의 소스·출력 길이, 개수, 크기 상한을 각 문서 페이지 링크와 함께 정리했습니다.

읽는 시간 6분Sume

Sume의 영상 편집 API는 소스 길이 상한을 영상 필터와 영상 프레임은 300초, 영상 트림, 오디오 분리, 영상 검사는 1,800초로 둡니다. Timeline 1.0 렌더는 최대 200개 슬롯으로 1초에서 1,800초 길이를 출력하고, 타임라인 합성은 최대 300초를 출력합니다. 아래 표는 도구별로 문서화된 길이, 개수, 크기 상한을 정리한 것입니다.

각 행에는 출처가 된 문서 페이지를 링크했으며, 자막 한도는 Sume API 레퍼런스에서도 가져왔습니다. 모두 2026-09-26에 확인했습니다. "현재"라고 설명한 동작은 Sume의 코드에서 확인한 것입니다.

미디어 도구별 상한은 어떻게 되나요?

길이는 초 단위입니다. "소스"는 입력 파일이고, "출력"은 Job이 만들어 내는 결과입니다.

각 행에 링크한 문서 페이지와 Sume API 레퍼런스 기준, 2026-09-26 확인.
도구	길이	개수와 크기
영상 트림, `POST /v1/video-trim`	소스 ≤ 1,800; 출력 0.2–900	`output` 너비와 높이 256–2160; `fps` 24, 25, 30, 60 중 하나(exact 정밀도만)
영상 필터, `POST /v1/video-filter`	소스 ≤ 300	op ≤ 8개; `filtergraph` ≤ 2,048자, 이름 있는 필터 ≤ 32개; crop 변 ≥ 0.05
오디오 분리, `POST /v1/audio-detach`	소스 ≤ 1,800; 출력 ≤ 900(더 긴 트랙은 `range` 필요)	`sample_rate` 16000, 44100, 48000 중 하나; mp3는 128 kbps
영상 프레임, `POST /v1/video-frames`	소스 ≤ 300	`at` 값 1–24개, 또는 `fps` ≤ 2(최대 24프레임); `max_edge` 16–2160
영상 검사, `POST /v1/video-inspect`	소스 ≤ 1,800; 전사 힌트 ≤ 600	스틸 ≤ 24장(기본 8장); `max_edge` 64–2160(기본 768)
영상 캡션, `POST /v1/video-captions`	60 이하 영상 기준으로 가격 책정	`words` ≤ 1,200; `cues` ≤ 200; 시각 0–60; `script_text` ≤ 8,000자
Timeline 1.0, `POST /v1/timeline-1.0/render`	출력 1–1,800; 슬롯마다 ≥ 0.2	슬롯 1–200개; 오디오 part ≤ 20개; 출력은 짝수 256–2160
타임라인 합성, `POST /v1/timeline-1.0/compose`	출력 ≤ 300	스틸 하나와 영상 하나; 출력 256–2160
타임라인 오디오, `POST /v1/timeline-1.0/audio`	생성되는 오디오 ≤ 1,800	`parts`(concat) 또는 `ranges`(split) 1–20개

모든 미디어 도구에 적용되는 규칙은 무엇인가요?

일부 한도는 도구별이 아니라 공통으로 적용됩니다.

입력: 트림, 필터, 오디오 분리, 프레임, 검사, 그리고 세 가지 Timeline 도구는 여러분 워크스페이스에 있는 media.sume.com 아티팩트나 에셋만 읽습니다. 자막은 공개 HTTPS 영상 URL을 받습니다.
대기: mode: "sync"는 요청을 최대 30초 동안 붙잡아 둡니다. 트림, 필터, 오디오 분리, Timeline 도구의 기본값은 async, 검사의 기본값은 sync이며, 영상 프레임은 항상 202로 응답합니다.
키: 트림, 필터, 오디오 분리, 검사, Timeline 도구에는 Idempotency-Key가 필수입니다. 영상 프레임은 MCP 쓰기에서 이 키가 필수이며, 문서는 REST에서도 보내라고 안내합니다.
argv 금지: codec 같은 ffmpeg 필드는 트림, 필터, 오디오 분리, 프레임, 검사에서는 ffmpeg_fields_rejected로, Timeline 도구에서는 400으로 거부됩니다.

어떤 상한은 제출할 때 실패하고, 어떤 상한은 나중에 실패하나요?

요청 형태에 대한 상한은 제출 시점에 400으로 실패합니다. 파일에 따라 달라지는 길이 상한은 워커가 소스를 프로브한 뒤에 검사하므로, 이때는 Job이 실패합니다.

source_duration_exceeded: 1,800초보다 긴 트림 또는 오디오 분리 소스.
output_duration_exceeded: 300초보다 긴 필터 소스.
duration_out_of_range: 300초보다 긴 영상 프레임 소스.
frame_time_out_of_range: 프로브된 길이와 같거나 그보다 뒤인 at 값.
일부 한도는 실패하는 대신 값을 제한합니다. 소스를 넘는 트림 end는 trim_clamped_to_source 경고를, 파일을 넘는 합성 video.duration은 compose_duration_clamped_to_source 경고를 냅니다.

Timeline의 세부 한도는 무엇인가요?

길이와 슬롯 수 외에도 Timeline 1.0과 합성은 다음 값을 검사합니다.

전환 효과: 최대 1초, 더 짧은 이웃 슬롯 길이의 50% 이하, 출력 프레임 최소 한 장입니다. 인접한 페이드가 8개를 넘으면 too_many_chained_transitions로 실패합니다.
render.strategy: "single"은 슬롯이 12개를 넘으면 거부됩니다(render_strategy_unsafe). 출력 앞뒤의 페이드는 각각 0–5초이며, 합계가 출력 길이 안에 들어가야 합니다.
soundtrack: fade_out_seconds ≤ 10, duck_db 0–20. audio.gain_db: −60에서 12. 영상 커버리지는 스파인보다 최대 0.5초까지 짧아도 됩니다.
합성 stack: ratio 0.1–0.9. 합성 overlay: width_ratio 0.05–1, margin_ratio 0–0.45.

긴 녹화 영상에는 이 상한이 어떤 의미인가요?

30분짜리 녹화 영상은 검사, 트림, 오디오 분리의 상한 안에 들어가지만(오디오 분리는 900초 이하의 range를 한 번에 하나씩), 필터나 프레임의 상한은 넘습니다. 트림으로 900초 이하 클립으로 자르고(필터나 프레임을 호출하기 전이라면 300초 이하), Timeline 1.0으로 최대 1,800초까지 조립하세요. 자막 페이지는 독립 실행형 자막 Job의 가격을 60초 이하 영상 기준으로 매기며, 현재 자막 워커는 더 긴 소스를 duration_out_of_range로 거부합니다. 이 워크플로는 긴 영상을 짧은 클립으로 나누기에서 단계별로 설명합니다.

출처

작성자 Sume