가이드
Sume 가이드: API, 포맷, 에이전트, 모델, 미디어 도구, 요금을 다룹니다. 답마다 날짜와 출처를 붙였습니다.
스토리보드를 AI 영상으로: 각 프레임을 샷으로 만들기
스토리보드는 프레임 하나씩 영상으로 만드세요. 스케치를 스틸로 렌더링하고, 각 스틸을 클립의 첫 프레임으로 움직인 뒤, 클립을 순서대로 이으세요.
AI로 만화 컷을 움직일 수 있나요? 네, 컷마다 클립 하나
네, 만화 컷 하나하나를 짧은 AI 클립의 첫 프레임으로 쓰고, 타임라인에서 클립을 읽는 순서대로 이어 소리가 있는 모션 코믹을 만들 수 있습니다.
Vercel 함수 타임아웃과 영상 생성: 웹훅을 쓰세요
Vercel Function은 기본적으로 300초에 멈추지만 Sume 영상 실행은 몇 분이 걸립니다. webhook_url과 함께 제출하고 바로 반환한 뒤, 서명된 POST를 검증하세요.
n8n AI 영상 워크플로: Sume 웹훅으로 Wait 노드 재개하기
n8n HTTP Request 노드에서 Sume Format 실행을 시작하고 Wait 노드의 재개 URL을 webhook_url로 넘긴 뒤, 끝난 실행을 API 키로 읽으세요.
Zapier AI 영상 자동화: Zap 두 개와 Sume 웹훅 하나
Zap 하나는 Custom Request로 Sume 영상 실행을 시작하고, 두 번째 Zap은 Catch Raw Hook으로 Sume의 서명된 웹훅을 받아 Code 단계에서 검증합니다.
Google Sheets 영상 자동화: Apps Script와 Sume
Apps Script 요청 한 번으로 시트 행 최대 100개를 Sume 영상 실행으로 바꾸고, 시간 기반 트리거로 큐를 폴링해 URL을 다시 시트에 쓰세요.
n8n Google Sheets로 행마다 Sume AI 아바타 영상 만들기
n8n Google Sheets 노드로 행을 읽고, 행마다 Sume 말하는 아바타 Job을 하나씩 제출한 뒤, 상한이 있는 루프로 폴링해 영상 URL을 시트에 기록하세요.
Make.com AI 영상 시나리오: Sume HTTP 요청과 웹훅
Make.com AI 영상 시나리오를 둘로 나누세요. Make a request가 Sume 실행을 시작하고, 커스텀 웹훅이 서명된 결과를 받아 sha256()으로 확인합니다.
Express 웹훅 서명 검증: raw body와 100kb 한도
Sume 웹훅 라우트에 type은 application/json, limit은 1 MiB보다 크게 설정한 express.raw를 붙이고, 원본 Buffer를 verifyWebhook에 넘기세요.
OpenAI Agents SDK MCP 서버: Sume와 5초 타임아웃
API 키로 OpenAI Agents SDK를 Sume 호스팅 MCP 서버에 연결하고, 기본 5초인 클라이언트 타임아웃을 jobs_wait의 55초보다 길게 늘리세요.
Shopify 제품 영상 AI API: products/create 웹훅
Shopify products/create 웹훅에 오 초 안에 응답하고, 큐에서 Sume Format을 실행한 뒤 staged upload로 MP4를 Shopify에 올리세요.
FastAPI·Django에서 Python 웹훅 HMAC 검증하기
Python에서 Sume 웹훅 검증하기: timestamp.raw_body에 대한 HMAC-SHA256을 계산하고, 서명 헤더를 쉼표로 나눠 상수 시간으로 비교한 뒤 빠르게 응답하세요.
Cloudflare Workers로 Sume 영상 웹훅을 Queue에 넣기
Cloudflare Worker에서 Sume의 서명된 POST를 검증하고 작은 메시지를 큐에 넣은 뒤 204로 빠르게 응답하세요. Queue 메시지는 128 KB, 영수증은 최대 1 MiB입니다.
Supabase Edge Function의 Sume 웹훅: JWT 대신 HMAC
Sume의 웹훅 POST에는 Supabase JWT가 없으므로 Edge Function을 verify_jwt = false로 배포하고, 모든 전달에서 Sume의 HMAC 서명을 확인하세요.
Vercel Cron Jobs: 중복 없이 매일 Sume API 호출하기
Vercel cron job이 라우트에 GET을 보내면 라우트가 날짜 기반 Idempotency-Key로 Sume API를 호출하므로, 중복 호출이 두 번 과금될 수 없습니다.
GitHub Actions: Sume Format으로 릴리스 영상 만들기
GitHub 릴리스가 게시되면 Sume Format 실행을 시작하고, 릴리스 노트를 input으로 넘기고, 영상이 준비될 때까지 폴링한 뒤 릴리스에 첨부하세요.
Pipedream에서 Sume 영상 실행의 웹훅 콜백 기다리기
Sume 영상 실행을 시작하는 단계에서 $.flow.suspend()를 호출하고 resume_url을 webhook_url로 넘기면, Sume가 결과를 POST할 때 Pipedream이 재개합니다.
Sume Format을 실행하는 LangChain 영상 생성 도구
LangChain @tool은 Sume Format 실행을 시작하고, 지출 상한을 두고, 안전한 재시도용 키를 붙이고, 영상이 준비될 때까지 에이전트가 확인할 실행 id를 돌려줄 수 있습니다.
Claude Agent SDK MCP 서버: API 키로 Sume 연결
API 키 헤더로 Sume 호스팅 MCP 서버를 Claude Agent SDK에 추가하고, 필요한 도구만 허용하고, 유료 호출은 제출 전에 dry-run으로 확인하세요.
Trigger.dev 웹훅 대기: Sume 실행용 waitpoint 토큰
Trigger.dev waitpoint 토큰을 만들고 token.url을 Sume 실행의 webhook_url로 보내면, Sume가 실행 결과를 POST할 때 wait.forToken()이 반환됩니다.
ngrok·Cloudflare Tunnel로 Sume 웹훅 로컬 테스트하기
Sume는 localhost 웹훅 URL을 거부합니다. ngrok이나 Cloudflare Quick Tunnel로 핸들러를 노출하고, 서명된 테스트를 보낸 뒤, 실제 이벤트를 다시 보내세요.
가상 착용(Virtual Try-On) 영상 API: 사람에게 옷 입히기
Sume API로 가상 착용 영상을 만들려면 사진을 담아 sume-virtual-try-on이나 sume-virtual-fitting을 호출하거나, 스틸을 만든 뒤 움직임을 입히세요.
제품 사진 영상 변환 API: SKU 사진으로 만드는 이커머스 클립
Sume API로 제품 사진을 영상으로 만들려면 제품에 맞는 카탈로그 Format을 호출하거나, 사진을 첫 프레임으로 넣어 움직임을 입히세요.
비포 애프터 영상 생성 API: 변화를 드러내는 장면 만들기
Sume API로 비포 애프터 영상을 만들려면 sume-before-after Format을 호출하거나, 첫·마지막 프레임을 지정한 클립을 만들거나, 스틸 두 장을 Timeline 와이프로 이으세요.
로고 애니메이션 API: 브랜드 마크를 아이덴트·엔드 카드로
Sume API로 로고 애니메이션을 만들려면 마크를 첨부해 sume-logo-motion-design을 호출하거나 첫 프레임으로 넣어 직접 움직이게 하고, 엔드 카드로 붙이세요.
Image-to-Video 제품 로고 왜곡: 프레임 vs 레퍼런스
Sume의 이미지로 영상 만들기 API에서 frame_images에 넣은 팩샷은 첫 프레임을 지정하고, input_references는 가이드 역할만 합니다. 추출한 스틸로 라벨을 확인하세요.
제품을 든 AI 모델: API로 사진과 영상 만들기
Sume API로 AI 모델이 제품과 포즈를 잡게 하세요. 스틸은 sume-model-product-portrait, 영상은 sume-beauty-studio를 쓰거나 이미지 편집을 직접 제어하세요.
AI 패션 영상 생성 API: 에디토리얼 필름과 룩북
Sume API로 AI 패션 에디토리얼 영상을 만드세요. 룩마다 sume-fashion-editorial을 실행하거나, 룩북을 대량 실행으로 큐에 넣거나, 커버 스틸을 직접 영상으로 만들면 됩니다.
모바일 앱 광고 영상 생성 API: 크리에이터 데모와 엔드 카드
Sume API로 모바일 앱 광고를 만드세요. 앱 스크린샷으로 sume-mobile-app-ugc를 실행하고, 로고 엔드 카드를 더한 뒤, Timeline 1.0으로 두 클립을 이어 붙이면 됩니다.
AI 제품 데모 영상 생성 API: 실제 동작 하나 보여 주기
Sume로 제품 데모 영상을 만들려면 팩샷과 동작 하나를 담아 sume-product-usage-demo Format을 실행하거나, 스틸을 영상으로 만든 뒤 Timeline에서 이어 붙이세요.
Format으로 제품 사진 한 장에서 마케팅 에셋 만들기
Sume로 제품 사진 한 장에서 마케팅 에셋을 만들려면 에셋마다 카탈로그 Format을 한 번씩 실행해 같은 팩샷을 첨부하고, 실행마다 멱등성 키와 지출 상한을 두세요.
AI 잡지 표지 생성 API: 글자 넣을 자리를 남긴 표지
Sume로 잡지 표지 스타일 이미지를 만들려면 사진을 담아 sume-magazine-cover-campaign Format을 실행한 뒤, 제호(마스트헤드)는 직접 얹으세요.
얼굴 없는 숏폼 영상 자동화: 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 키가 필요 없는 경로, 계량 요율 대신 호출 한 번에 정해진 금액을 받는 유료 호출을 정리했습니다.
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 하나는 없습니다. 과금 단위, 모델, API 구조, 한도를 비교한 뒤 돌려받을 결과물로 고르세요.
AI 영상 출력용 JSON 스키마: 복사해 쓰는 템플릿 5개
Sume에서 AI 영상 출력에 쓸 JSON Schema 템플릿입니다. 영상 하나, 영상과 게시 문구, 포스터, 화면 비율, 자막 큐를 모두 strict 부분집합 안에서 복사해 쓸 수 있습니다.
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를 맞추는 법.