가이드
Sume 가이드: API, 포맷, 에이전트, 모델, 미디어 도구, 요금을 다룹니다. 답마다 날짜와 출처를 붙였습니다.
AI 제품 데모 영상 생성 API: 실제 동작 하나 보여 주기
Sume로 제품 데모 영상을 만들려면 팩샷과 동작 하나를 담아 sume-product-usage-demo Format을 실행하거나, 스틸을 영상으로 만든 뒤 Timeline에서 이어 붙이세요.
Format으로 제품 사진 한 장에서 마케팅 에셋 만들기
Sume로 제품 사진 한 장에서 마케팅 에셋을 만들려면 에셋마다 카탈로그 Format을 한 번씩 실행해 같은 팩샷을 첨부하고, 실행마다 멱등성 키와 지출 상한을 두세요.
AI 잡지 표지 생성 API: 글자 넣을 자리를 남긴 표지
Sume로 잡지 표지 스타일 이미지를 만들려면 사진을 담아 sume-magazine-cover-campaign Format을 실행한 뒤, 제호(마스트헤드)는 직접 얹으세요.
영상 배경 음악 API: API 키 없는 Sume BGM 카탈로그
Sume BGM 카탈로그 API는 API 키가 필요 없습니다. 큐레이션 트랙 66개를 분위기나 카테고리로 조회하고, 트랙별 license 필드를 확인하거나 /v1/bgm/pick에 선택을 맡기세요.
얼굴 없는 숏폼 영상 자동화: AI 보이스오버, 자막, 음악
얼굴 없는 숏폼 영상 자동화 방법: 대본, AI 보이스오버, B-roll, 음악, 9:16 렌더와 자막을 API나 에이전트 호출 한 번으로 만들고, 확인 날짜를 적은 도구 비교표도 담았습니다.
영상 자막 번역 API: 영어 자막을 한국어 자막으로
Sume로 영어 영상의 자막을 한국어로 번역하세요. 타이밍이 있는 문장을 받아 줄마다 번역한 뒤, 그 줄을 cue로 보내 한글 스타일로 입힙니다.
Claude Code와 Sume MCP로 웹사이트 이미지 생성하기
Claude Code를 Write 권한으로 Sume 호스팅 MCP에 연결하고, dry_run으로 비용을 미리 본 뒤, 사이트 이미지를 생성해 저장소에 저장하세요.
무료 AI 영상 API 호출: Sume의 과금 없는 검사와 정액 요금
과금되지 않는 Sume API 호출, API 키가 필요 없는 경로, 계량 요율 대신 호출 한 번에 정해진 금액을 받는 유료 호출을 정리했습니다.
API로 영상 요약하기: 전사문, 스틸, 그리고 JSON
Sume에 호스팅된 영상을 요약하려면 POST /v1/video-inspect로 스틸과 전사문을 뽑은 뒤, 둘 다 output_schema와 함께 Agent Completions로 보내세요.
Sume API 상태 값 정리: Job, 실행, 큐, 웹훅
Sume API 상태 값을 한곳에 모았습니다. Job, /v1/videos, Format·Agent 실행, 대량 실행 큐, 웹훅 전달, 사용량 행, 공유 권한, 잔액까지 다룹니다.
Sume API 오류 코드 총정리: 표면별 색인과 다음 조치
Sume API 오류 코드를 표면별로 정리했습니다. 공통 코드, 유료 생성, Format, Scheduled 실행, Agent Completions, 미디어 도구, 호스팅 MCP를 다룹니다.
Sume API 페이지네이션: cursor·starting_after·한도
Sume 목록 엔드포인트별 페이지 넘김 방식입니다. Format과 실행 목록은 cursor와 has_more, /v1/jobs는 starting_after를 쓰고, limit만 받는 목록에는 커서가 없습니다.
Sume API 헤더: 인증, 멱등성 키, If-Match, 요청 한도
Sume API가 읽거나 보내는 모든 HTTP 헤더를 정리했습니다. API 키, Content-Type, Idempotency-Key, If-Match, 요청 ID, 요청 한도, 웹훅 서명을 다룹니다.
Sume API 용어집: Format 실행, 지출 상한, 멱등성 키
Sume API 용어를 한두 문장씩 설명합니다. Format, 실행, Job, 지출 상한, 멱등성 키, 지갑, 에이전트 수수료, 웹훅, 아티팩트 등을 관련 글 링크와 함께 정리했습니다.
Sume란 무엇인가요? 영상 에이전트 플랫폼과 API, 요금
Sume는 영상 에이전트 플랫폼입니다. 채팅에서 에이전트에게 브리프를 주고, 레시피를 Format으로 저장해 백엔드에서 API 하나로 호출합니다. 제품 표면과 요금을 정리했습니다.
Sume 에이전트 수수료란 무엇인가요? 기본 5.5%의 의미
Sume 에이전트 수수료는 요청의 모델 금액 위에 더해 청구되며, 기본값은 5.5%입니다. API가 이 수수료를 어디에 보고하고 수수료 항목을 어떻게 읽는지 정리했습니다.
스크립트로 AI 아바타 영상 만드는 API, 어떻게 고르나요?
스크립트로 AI 아바타 토킹 헤드 영상을 만드는 API 고르는 법: HeyGen, Synthesia, Argil, Creatify, Sume를 과금 단위, 엔진, 한도로 비교합니다.
개발자용 AI 영상 생성 API 추천: 고르는 방법
모든 개발자에게 가장 알맞은 AI 영상 생성 API 하나는 없습니다. 과금 단위, 모델, API 구조, 한도를 비교한 뒤 돌려받을 결과물로 고르세요.
AI 영상 출력용 JSON 스키마: 복사해 쓰는 템플릿 5개
Sume에서 AI 영상 출력에 쓸 JSON Schema 템플릿입니다. 영상 하나, 영상과 게시 문구, 포스터, 화면 비율, 자막 큐를 모두 strict 부분집합 안에서 복사해 쓸 수 있습니다.
AI 생성 영상 URL은 만료되나요? Sume의 결과물 보관 방식
Format 실행과 Agent Completions에서는 만료되지 않습니다. Sume는 그 미디어를 만료되지 않는 media.sume.com URL로 돌려주며, 링크를 가진 누구나 열 수 있습니다.
Sume API에서 생성한 영상 다운로드하기: 401과 302
Sume의 unsigned_urls는 API 키가 필요하고 302 리다이렉트로 응답합니다. curl -L이나 코드로 MP4를 내려받고, 401, 404, 409를 각각 해결하세요.
웹훅 URL이 유효하지 않다고 거부되나요? Sume 웹훅 URL 규칙
웹훅 URL이 공개 HTTPS가 아니면 Sume는 400 invalid_request로 응답합니다. 스킴, 호스트, 포트, 자격 증명 규칙과 전달 시점의 검사를 정리했습니다.
Claude 커스텀 커넥터로 Sume 추가하기 (원격 MCP)
Customize > Connectors에서 Sume 호스팅 MCP 서버를 Claude에 추가하고, Sume OAuth 동의가 무엇을 부여하는지 확인한 뒤, 유료 도구를 허용할지 정하세요.
VS Code 원격 MCP 서버: mcp.json에 Sume MCP 추가
mcp.json의 http 항목으로 Sume 호스팅 MCP 서버를 VS Code에 추가하고, Sume OAuth 동의가 무엇을 부여하는지 확인한 뒤, 채팅이 호출할 도구를 고르세요.
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 제품 사진을 영상으로 자동 변환하는 방법
Shopify 제품 사진을 App Store 앱, URL 영상 변환 도구, 이미지로 영상 만들기 API 파이프라인으로 자동 변환하는 방법과 옵션별 가격, 한도를 정리합니다.
영상 프레임으로 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로 읽힌 뒤, 새 음성 위에 영상을 렌더링합니다.
Sume API 미디어 URL 규칙: 엔드포인트별 허용 URL
Sume 생성 엔드포인트는 공개 HTTPS 미디어 URL을 가져옵니다. 트림, 필터, 프레임, 검사, Timeline은 워크스페이스에 있는 media.sume.com URL만 받습니다.
Sume Job 타입과 동시성: 슬롯을 차지하는 호출
Sume 엔드포인트별 Job 타입과 슬롯 사용 여부입니다. 트림과 Timeline을 포함한 모든 생성 Job은 동시성 슬롯을 차지하고, 프레임과 검사는 차지하지 않습니다.
Sume API 엔드포인트 목록: 경로, 스코프, 멱등성
Sume API의 공개 경로를 계열별로 정리한 색인입니다. 키가 필요 없는 경로, 계열별 스코프, Idempotency-Key 적용 위치, 계열별 설명 글을 담았습니다.
Sume API 출력 파일 형식: MP4·PNG·WebP·WAV·MP3
Sume API 엔드포인트별로 반환하는 파일입니다. Timeline과 편집 도구는 MP4, 이미지는 PNG·JPEG·WebP, 오디오는 WAV나 MP3, 전사문은 JSON입니다.
브라우저에서 Sume API 호출 시 CORS 오류: 해결 방법
브라우저는 내 사이트에서 api.sume.com으로 직접 보내는 호출을 차단하며, API 키는 프론트엔드 코드에 절대 넣으면 안 됩니다. 서버에서 Sume를 호출해 프록시하세요.
Seedance 2.5 API: 30초 클립, 해상도, 레퍼런스
Sume의 Seedance 2.5는 seedance-2.5로, 480p, 720p, 1080p의 4–30초 클립을 만듭니다. Seedance ID별로 문서화된 한도, 입력, 과금을 정리했습니다.
Sora API 종료 후 영상 생성 API 대안
Sora API는 September 24, 2026에 종료됐습니다. Runway, Kling, fal, Replicate, Sume를 모델, 오디오, 과금 단위, API 형태, 한도로 비교합니다.
AWS Lambda로 Sume 웹훅 받기: 함수 URL과 HMAC
인증 유형이 NONE인 Lambda 함수 URL을 Sume에 넘기고, 이벤트 본문을 디코딩해 sume-v1 HMAC을 확인한 뒤 10초 시도 시간 안에 204로 응답하세요.
Inngest 이벤트 대기: Sume 영상 실행이 끝나면 재개
step.run에서 Sume 실행을 시작하고, transform으로 웹훅을 Inngest 이벤트로 바꾼 뒤, 실행 id를 기준으로 2시간 타임아웃을 둔 step.waitForEvent로 기다리세요.
LlamaIndex 이미지 생성 도구: Sume Image API
POST /v1/images를 LlamaIndex FunctionTool로 감싸세요. sume/auto와 프롬프트를 보내고, 200이면 URL을, 202이면 Job id를 돌려주면 됩니다.