블로그

미디어 도구

API로 쓰는 Sume 미디어 도구를 다룹니다. 자르기, 필터, 자막, 프레임, 검사, 음성 인식, 업스케일, 배경 제거, 전환 효과, 타임라인 조립을 정리했습니다.

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

영상 배경 음악 API: API 키 없는 Sume BGM 카탈로그

Sume BGM 카탈로그 API는 API 키가 필요 없습니다. 큐레이션 트랙 66개를 분위기나 카테고리로 조회하고, 트랙별 license 필드를 확인하거나 /v1/bgm/pick에 선택을 맡기세요.

영상 자막 번역 API: 영어 자막을 한국어 자막으로

Sume로 영어 영상의 자막을 한국어로 번역하세요. 타이밍이 있는 문장을 받아 줄마다 번역한 뒤, 그 줄을 cue로 보내 한글 스타일로 입힙니다.

TikTok 영상 규격: API 업로드와 광고, Sume로 맞추기

TikTok 게시 API는 MP4, WebM, MOV를 23–60 fps, 360–4,096 px, 최대 10분까지 받습니다. Sume 클립을 이 기준에 맞추고 업로드하는 방법입니다.

Instagram Reels API 업로드 영상 요구 사항

Instagram API는 공개 video_url의 Reels를 cURL로 가져옵니다. MP4·MOV, H.264·HEVC, 23–60 fps, 3초–15분, 300 MB 규칙마다 Sume MP4를 맞추는 법.

Meta 영상 광고 규격: 4:5 피드·9:16 Reels·세이프 존

Meta는 Facebook Feed 영상 광고에 4:5(1440×1800)를, Instagram에 9:16과 Reels 세이프 존을 제시합니다. Sume로 각 규격을 만들고 자막을 배치하는 법입니다.

YouTube Shorts 영상 규격: 3분, 정사각형 또는 세로

YouTube는 3분 이하의 정사각형·세로 업로드를 Shorts로 분류하고 MP4, H.264, AAC-LC, 48 kHz를 권장합니다. Sume 출력과 비교해 봅니다.

LinkedIn 영상 광고 규격: 30 fps 미만·4:5·SRT 자막

LinkedIn 영상 광고는 30 fps 미만의 H.264·VP8 MP4, 3초–30분, 최대 500 MB, SRT 자막을 받습니다. Sume로 24나 25 fps를 지정하고 4:5로 잘라 내세요.

AI 생성 클립을 위한 X(트위터) 영상 업로드 규격

X는 30 또는 60 fps의 H.264와 1280x720 또는 720x1280을 권장하고, 기본 계정의 Post 영상을 20분으로 제한합니다. Sume 클립을 항목별로 대조합니다.

Pinterest 핀 크기와 영상 규격: 2:3 이미지와 클립

Pinterest는 이미지 핀에 2:3 또는 1000x1500을 권장하고, 영상은 4초에서 15분까지 받습니다. Sume로 2:3 이미지를 만들고 9:16 클립은 2:3이나 4:5로 크롭하세요.

Amazon Sponsored Brands 영상 규격: 먼저 확인할 것

Amazon은 6–45초 16:9 영상, Main 또는 Baseline 프로필, 23.976–30 fps, 바 없음을 요구합니다. Sume Timeline 렌더가 정하는 것과 확인할 것을 살펴봅니다.

Shopify 제품 이미지 크기와 영상 규격: AI 미디어용

Shopify는 정사각형 제품 이미지에 보통 2048 x 2048 px가 가장 잘 표시된다고 안내합니다. Sume에 이 크기를 요청한 뒤 Shopify의 다른 상한을 확인하세요.

영상 프레임으로 YouTube 썸네일 만들기: 추출·업스케일 API

POST /v1/video-frames로 Sume에 호스팅된 영상에서 원본 크기 PNG를 추출한 뒤, YouTube가 썸네일에 권장하는 3840×2160으로 업스케일하세요.

API로 긴 영상에 자막 넣기: 나눠서 입히고 다시 잇기

Sume 자막 Job 하나는 최대 60초 길이의 영상을 받습니다. 더 긴 영상은 조각으로 잘라 조각마다 자막을 입힌 뒤, 원래 오디오 위에 다시 이어 붙이세요.

영상 편집 API: 편집 작업별로 쓸 Sume 엔드포인트

Sume 영상 편집 API의 작업별 엔드포인트 지도입니다. 자르기, 크롭, 자막, 잇기, 음성 교체에 어떤 호출을 쓰고 어떤 가이드를 보면 되는지 정리했습니다.

API로 영상 일부 잘라내기: 중간 구간을 빼고 다시 잇기

영상 트림은 Job 하나에 구간 하나만 남깁니다. 중간 구간을 잘라내려면 남길 구간들을 Sume Timeline 1.0 Job 하나에서 차례로 이어 렌더링하세요.

API로 영상 보이스오버 번역하기: STT, TTS, Timeline

Sume로 영상의 음성 트랙을 바꾸세요. 원래 음성을 전사하고, 대사를 직접 번역하고, TTS로 읽힌 뒤, 새 음성 위에 영상을 렌더링합니다.

API로 영상에 배경 음악 넣기: 루프, 페이드, 더킹

Sume Timeline 1.0 렌더에 사운드트랙을 더하면 Sume에 호스팅된 음악을 음성 스파인 아래에 믹싱할 수 있습니다. 레벨, 루프, 페이드아웃, 말소리 아래 더킹을 설정하세요.

Sume API로 가로 영상을 세로 9:16으로 변환하기

영상 필터로 Sume에 호스팅된 16:9 클립에서 9:16 영역을 잘라 내거나, 클립을 1080×1920 Timeline 렌더에 넣고 cover, contain, blur 중 하나로 맞춥니다.

Sume API로 긴 영상을 짧은 클립으로 나누기

영상 검사로 Sume에 호스팅된 영상을 전사해 자를 지점을 찾고, 영상 트림으로 구간마다 잘라 낸 뒤 짧은 클립마다 크롭과 자막을 적용합니다.

Sume API로 영상의 오디오를 교체하거나 제거하기

영상 트림의 audio: drop으로 클립의 오디오를 제거하거나, Timeline 1.0에서 Sume에 호스팅된 새 스파인 위에 클립을 렌더링해 교체하거나, gain_db로 레벨을 다시 맞추세요.

영상 전환 효과(트랜지션) API: 크로스페이드·와이프·슬라이드

Sume Timeline 1.0 렌더의 클립 사이에 페이드, 와이프, 슬라이드, 디졸브 트랜지션을 넣을 수 있습니다. 각각 최대 1초이고 정수 프레임으로 스냅되며, 연속으로는 최대 8개입니다.

이미지 슬라이드쇼 영상 API: 이미지와 음악으로 MP4 만들기

Timeline 1.0으로 Sume에 호스팅된 이미지를 슬라이드쇼 MP4로 만드세요. 스틸은 영상 슬롯으로, 길이는 무음 스파인으로, 음악은 루프되는 사운드트랙으로 지정합니다.

ffmpeg 필터 API: Sume 영상 필터 허용 목록과 검사

POST /v1/video-filter로 Sume에 호스팅된 클립에 허용 목록의 ffmpeg 필터를 적용합니다. 허용된 이름, filtergraph 규칙, 무료 검사, 인코딩 설정을 정리했습니다.

API로 영상의 마지막 프레임을 추출해 AI 클립 잇기

Sume에 호스팅된 클립의 길이와 fps를 무료로 프로브하고, 영상 프레임으로 마지막 프레임을 PNG로 추출한 뒤, 다음 first_frame으로 /v1/videos에 넘깁니다.

한국어 자막 API: 두부 글자 없는 한글 자막 스타일과 폰트

Sume 자막 API로 한국어 자막을 입히려면 한글을 지원하는 스타일과 폰트를 고르세요. 한국어 문구가 두부 글자가 아닌 한글 서체로 렌더링됩니다.

자막 자동 생성 API: 전사하고 문구를 고친 뒤 입히기

Sume로 자막을 자동 생성하세요. 영상 검사로 클립을 전사하고 문구를 고친 뒤, script_text 정렬로 영상에 자막을 입힙니다.

자막 커스터마이즈 API: 색, 위치, 크기, 줄당 단어 수

Sume의 design 객체로 영상에 입히는 자막을 커스터마이즈하세요. punch와 tiktok-green을 뺀 모든 스타일에서 색, 위치, 크기, 구절당 단어 수를 덮어씁니다.

Sume API로 영상의 프레임 레이트나 해상도 바꾸기

영상 트림의 output 필드나 영상 필터의 scale, fps 필터로 Sume에 호스팅된 클립의 크기와 fps를 맞추고, Timeline이 출력 프레임 레이트를 고르는 방식을 알아봅니다.

Sume API로 영상의 길이, 해상도, fps 확인하기

POST /v1/video-inspect에 frames: false를 보내면 Sume 호스팅 클립의 길이, 너비, 높이, fps, 오디오 유무, 코덱, HDR을 무료로 프로브합니다.

단어별 타임스탬프를 주는 음성 인식 API: Sume STT 1.0

공개 HTTPS 오디오 URL을 POST /v1/stt-1.0/transcribe로 보내면 단어마다 시작·끝 초가 붙은 전사문을 받고, 원하면 문장 구간도 받을 수 있습니다.

배경 제거 API: Sume RMBG 1.0으로 투명 PNG 만들기

공개 HTTPS 이미지 URL을 POST /v1/rmbg-1.0/remove로 보내면 알파 채널이 있는 PNG를 돌려받습니다. 크기와 관계없이 이미지당 요금은 하나입니다.

AI 이미지 업스케일러 API: Sume로 이미지를 최대 4배 확대

POST /v1/image-upscale-1.0/upscale은 공개 HTTPS 이미지 URL과 upscale_factor 1–4(기본값 2)를 받아 PNG·JPG·WebP 중 하나를 반환합니다.

AI 영상 업스케일러 API: 배율, 향상 등급, 비용

POST /v1/video-upscale-1.0/upscale은 공개 HTTPS 영상 URL, scale_ratio 1.1–4, fast·standard·pro 중 하나의 향상 등급을 받습니다.

렌더링 전 영상 타임라인 JSON 검증: Sume plan 사전 검사

POST /v1/timeline-1.0/plan은 Timeline 1.0 문서를 과금 없이 검사하고 길이, 과금 대상 분 수, 비용 추정치, 필터그래프 요약을 반환합니다.

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

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

Sume API로 영상에 자막을 입히는 방법

공개 HTTPS 영상 URL을 POST /v1/video-captions로 보내면 음성 인식이나 직접 넣은 텍스트로 타이밍을 맞춘 자막 영상을 Job 기반으로 받습니다.

Timeline 1.0 API로 롱폼 영상을 조립하는 방법

Timeline 1.0은 오디오 스파인 하나와 순서가 있는 영상 슬롯 1–200개를 MP4 하나로 렌더링합니다. 모든 URL은 Sume에 호스팅되어야 하며, plan 사전 검사는 과금되지 않습니다.

Sume 타임라인 합성·타임라인 오디오 API 사용법

타임라인 합성은 스틸 하나와 영상 하나를 같은 화면에 담아 새 MP4로 만듭니다. 타임라인 오디오는 Sume에 호스팅된 오디오를 이어 붙이거나 나눠 재사용할 파일로 만듭니다.

영상 검사 API: 클립 프로브, 스틸 샘플링, 전사문 받기

POST /v1/video-inspect는 Sume에 호스팅된 클립 하나를 읽어 프로브 정보, 샘플링한 스틸, 선택적 전사문을 반환합니다. 프로브와 스틸은 과금되지 않습니다.

Sume API로 영상에서 프레임을 추출하는 방법

POST /v1/video-frames는 Sume에 호스팅된 클립 하나에서 지정한 시각의 스틸을 소스 크기의 내구성 있는 이미지로 반환합니다. 이 호출은 과금되지 않습니다.

Sume API로 영상 트림, 필터, 오디오 분리하기

영상 트림은 구간을 잘라, 영상 필터는 dim이나 crop을 적용해 새 MP4를 만들고, 오디오 분리는 wav나 mp3를 추출합니다. 모두 Sume에 호스팅된 클립 하나를 받습니다.