가이드
Sume 가이드: API, 포맷, 에이전트, 모델, 미디어 도구, 요금을 다룹니다. 답마다 날짜와 출처를 붙였습니다.
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 파이프라인으로 자동 변환하는 방법과 옵션별 가격, 한도를 정리합니다.
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입니다.
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로 기다리세요.
OpenAI Responses API MCP 도구로 Sume 호출
Sume 호스팅 MCP 서버를 Responses API에 mcp 도구로 추가하고, Sume API 키는 headers로 보내고, 유료 도구 호출은 실행 전에 승인하세요.
Claude API MCP 커넥터와 Sume: 지금 쓸 수 있는 방법
Claude API의 MCP 커넥터로 Sume 호스팅 MCP에 인증하는 방법은 현재 문서화되어 있지 않습니다. 그 이유와 Agent SDK 같은 대안을 정리했습니다.
Gemini CLI MCP 서버: Sume 호스팅 MCP 추가하기
httpUrl과 환경 변수에서 읽는 API 키 헤더로 Sume 호스팅 MCP 서버를 Gemini CLI에 추가하고, 도구는 허용 목록으로 추린 뒤 호출 전에 확인하세요.
Windsurf MCP 서버: Devin Desktop에 Sume 추가
Windsurf는 이제 Devin Desktop입니다. API 키 헤더로 Sume 호스팅 MCP 서버를 Devin Local 에이전트나 레거시 Cascade 에이전트에 추가하세요.
Cline MCP 원격 서버: Sume 호스팅 MCP 추가하기
type을 streamableHttp로 지정하고 API 키 헤더를 넣어 Sume 호스팅 MCP 서버를 Cline에 원격 서버로 추가하고, 유료 도구는 autoApprove에서 빼 두세요.
Pydantic AI MCP 서버: 에이전트에 Sume 호스팅 도구 연결
MCPToolset과 API 키 헤더로 Pydantic AI 에이전트를 Sume 호스팅 MCP 서버에 연결하고, 도구를 걸러 내고, 유료 호출은 승인 전까지 보류하세요.
Google ADK MCP 도구: McpToolset으로 Sume 서버 연결
McpToolset, API 키 헤더, tool_filter로 Google ADK 에이전트에 Sume 호스팅 MCP 서버를 추가하고, 유료 도구는 실행 전에 확인을 받게 하세요.
Mastra MCP 클라이언트: 에이전트를 Sume 호스팅 MCP에 연결
MCPClient로 Mastra 에이전트를 Sume 호스팅 MCP 서버에 연결하세요. requestInit에 넣는 API 키 헤더, 도구 허용 목록, 유료 호출 승인을 다룹니다.
n8n MCP Client Tool과 Sume: 설정과 SSE 주의점
n8n은 MCP Client Tool 필드를 SSE Endpoint라 부르지만 Sume는 streamable HTTP를 문서화합니다. 설정하고 연결을 테스트한 뒤 유료 호출은 승인받게 하세요.
Dify OpenAPI 커스텀 도구: Sume API 스키마 가져오기
Sume OpenAPI 스키마로 Dify 커스텀 도구를 만드세요. 영상 오퍼레이션 세 개만 남겨 Swagger API 도구로 가져오고, 키는 비밀로 지킵니다.
Power Automate HTTP 요청 API: Sume 실행 시작과 폴링
Power Automate HTTP action으로 Sume API를 호출하세요. Format 실행을 시작하고, Do until 루프로 폴링하고, 키는 Key Vault 시크릿에서 읽습니다.
Bubble API Connector: Sume API로 AI 영상 생성하기
Sume용 Bubble API Connector 설정법입니다. 키는 비공개 헤더에 두고, 수동 응답으로 설정 비용을 없애고, 백엔드에서 Job을 폴링합니다.
Gradio 영상 생성 앱: Sume API 키는 Space 시크릿에
Sume API로 Gradio 영상 생성 앱을 만드세요. 키는 Hugging Face Space 시크릿에 두고, 제너레이터가 Job을 폴링하고, gr.Video가 영상을 재생합니다.
Telegram 영상 생성 봇: Sume Job 후 sendVideo
Telegram 봇은 /video 커맨드를 Sume Job으로 바꿔 곧바로 답한 뒤, Sume의 서명된 웹훅이 도착하면 아티팩트 URL로 sendVideo를 호출할 수 있습니다.
PHP 웹훅 서명 검증: 순수 PHP와 Laravel
PHP에서 Sume 웹훅 검증하기: timestamp.raw_body에 hash_hmac sha256을 적용하고, sume-v1 항목을 나눠 각각 hash_equals로 비교하세요.
Golang 웹훅 서명 검증: HMAC과 hmac.Equal
Go에서 Sume 웹훅 검증하기: io.ReadAll로 본문을 한 번 읽고, 타임스탬프와 원본 바이트에 HMAC-SHA256을 계산한 뒤, 각 sume-v1 항목을 hmac.Equal로 비교하세요.
Sume API로 AI 영상의 장면 하나를 다시 생성하기
AI 영상의 장면 하나를 다시 생성하려면 previous_run_id로 Sume Format 실행을 이어 가며 그 장면을 지정하세요. 그 클립만 다시 만들고 나머지는 그대로 둘 수 있습니다.
Sume Format 실행 실패: 오류 코드, 세부 정보, 대응 방법
실패한 Sume Format 실행은 error.code에 원인을 담습니다. 코드별 details 필드, 청구되는 비용, 이어 갈지 재시도할지를 정리했습니다.
프롬프트 인젝션과 사용자 입력: AI 에이전트 API에 데이터 넘기기
고객 텍스트는 Sume 실행의 instruction이 아니라 input 객체에 넣으세요. 에이전트는 이를 데이터로 읽으라는 안내를 받으며, 문서는 이를 샌드박스가 아닌 신뢰 경계라고 부릅니다.
Sume Format 레시피용 SKILL.md 파일 작성법
Sume Format 레시피는 SKILL.md 파일과 참고 파일로 이뤄집니다. SKILL.md는 짧은 색인으로 두고, 세부 내용은 references/로 옮기고, 패키지 규칙을 지키세요.
Sume 실행이 AI 생성 영상을 전달했는지 확인하는 방법
Sume 실행을 전달 완료로 세기 전에 status와 primary_output_url을 확인하고, filled_by를 읽고, 파일을 프로브하세요. Sume가 검사하는 것과 하지 않는 것을 정리했습니다.
장면 원장으로 실패한 AI 영상 실행의 부분 결과 받기
출력 스키마가 부분 결과를 허용하면 실패한 Sume Format 실행도 만든 장면을 보고합니다. nullable 필드를 쓰고, minItems는 빼고, primary 키를 지정하세요.
If-Match 낙관적 동시성: API로 Sume Format 파일 편집
다른 작성자의 변경을 덮어쓰지 않고 API로 Sume Format 파일을 편집하세요. 쓰기마다 파일의 blob sha를 보내고, If-Match가 패키지 전체를 지킵니다.
AI 영상 워크플로를 다른 팀과 공유: Sume Format 공유 권한
Sume 팀 Format을 다른 팀 워크스페이스와 공유하세요. 공유 권한이 활성화되면 그 팀은 자기 팀 키로 소유자의 주소를 호출하고, 실행 비용도 직접 냅니다.
strict 모드 JSON Schema oneOf 미지원: 위반 항목 고치기
Sume는 OpenAI strict 모드 부분집합을 벗어난 output_schema를 400 output_schema_invalid로 거부합니다. 위반마다 rule을 읽고 oneOf와 nullable을 옮기세요.
AI 에이전트가 지시를 무시했다면? Sume Format 실행 디버깅
Sume Format 실행이 예상과 다르게 동작했을 때 쓰는 체크리스트입니다. 조합된 첫 메시지, 전달된 지시문, 버전, 이벤트, 출력을 차례로 확인합니다.
프로덕션 AI 에이전트 프롬프트 버전 관리: Sume Format
Sume Format은 편집할 때마다 버전이 올라가고, 실행 영수증마다 실제로 실행된 버전이 기록됩니다. 실행을 특정 버전에 고정할 수 없고, 롤백 API도 없습니다.
AI 영상 배치 실패 항목 재시도: Sume 대량 실행 복구
Sume 대량 실행 큐가 완료되면 counts.failed를 읽고, 결과물을 남긴 실패한 자식 실행은 이어 가거나 새 Idempotency-Key로 다시 제출하세요.
UGC 스타일 제품 영상 광고를 대량으로 만드는 도구 비교
입력, 진행자, 언어, 물량에 따라 다릅니다. Arcads, Creatify, HeyGen, Runway, Synthesia, Sume를 API, 요금, 한도 기준으로 비교합니다.