가이드
Sume 가이드: API, 포맷, 에이전트, 모델, 미디어 도구, 요금을 다룹니다. 답마다 날짜와 출처를 붙였습니다.
Image-to-Video와 Reference-to-Video의 차이는?
이미지로 영상 만들기는 이미지를 첫 프레임으로 쓰고, 레퍼런스로 영상 만들기는 이미지·클립·오디오를 가이드로 씁니다. 언제 무엇을 쓰고, 함께 보내면 무엇이 우선하는지 정리했습니다.
AI로 사진을 움직이게 하는 법: 원하는 움직임 고르기
사진을 이미지로 영상 만들기 모델에 첫 프레임으로 넣고 움직임을 설명하세요. 춤을 따라 하게 하려면 모션 컨트롤, 얼굴이 말하게 하려면 립싱크를 씁니다.
AI로 옛날 사진을 움직일 수 있나요? 인화 사진을 영상으로
네. 인화 사진을 스캔해 공개 링크에 올리고, 이미지로 영상 만들기 클립의 첫 프레임으로 보내세요. 업스케일, 사진 비율, 기대할 수 있는 결과를 다룹니다.
끊김 없는 AI 루프 영상: 시작 장면으로 끝나는 클립 만들기
AI 영상을 루프로 만들려면 이미지 하나를 첫 프레임과 마지막 프레임으로 모두 보내고, 반복 재생하기 전에 양 끝을 비교하세요. 끝 프레임을 받는 모델도 정리했습니다.
AI 영상 시드란 무엇인가요? 시드 없이 같은 결과 얻기
시드는 생성기의 무작위 시작점을 고정합니다. Sume 영상 모델은 시드를 받지 않고 이 필드를 거부합니다. 시드 없이 클립이나 룩을 유지하는 법을 정리했습니다.
AI 영상 네거티브 프롬프트: 클립에서 원치 않는 요소 빼는 법
Sume 영상 API에는 네거티브 프롬프트 필드가 없고, 현재는 보내면 400이 반환됩니다. 원하는 샷을 설명한 뒤 샷의 프레임, 룩, 소리를 고정하세요.
AI로 내 노래 뮤직비디오를 만들 수 있나요? 네, 클립 단위로
네, 곡에 맞춰 편집한 짧은 AI 클립들로 만들 수 있습니다. Sume에서 클립 하나는 최대 30초이므로 곡의 구간마다 샷을 하나씩 계획하세요.
이미지 여러 장으로 AI 영상 만들기: 프레임, 레퍼런스, 스틸
Sume에서 AI 클립 하나는 이미지 두 장을 첫 프레임과 마지막 프레임으로 받습니다. 그보다 많다면 두 장씩 클립을 잇거나, 레퍼런스로 쓰거나, 스틸로 보여 주세요.
AI 영상 4K 화질 프롬프트: 해상도를 실제로 정하는 것
프롬프트에 4K라고 써도 Sume에서 해상도가 정해지지는 않습니다. 4K를 나열한 모델의 resolution 필드로 4K를 요청하거나, 완성된 클립을 업스케일하세요.
AI로 스토리를 영상으로 만들 수 있나요? 네, 샷 단위로
네, AI는 스토리를 짧은 샷의 연속으로 영상화합니다. 샷마다 스틸을 승인해 움직이게 하고, 대사에 목소리를 입힌 뒤, 샷을 순서대로 이으세요.
스토리보드를 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초보다 길게 늘리세요.
Vercel AI SDK: Sume API 도구 호출로 영상 생성하기
Vercel AI SDK에서는 서버에서 Sume의 POST /v1/videos를 호출하는 tool()로 영상을 생성하세요. 도구는 Job id를 돌려주고, 클립은 폴링으로 받습니다.
Shopify 제품 영상 AI API: products/create 웹훅
Shopify products/create 웹훅에 오 초 안에 응답하고, 큐에서 Sume Format을 실행한 뒤 staged upload로 MP4를 Shopify에 올리세요.
Python Text-to-Video API: 제출, 폴링, 다운로드
텍스트로 영상을 만드는 Sume API를 Python Requests로 호출하세요. POST /v1/videos 후 타임아웃을 두고 폴링하고, content 경로가 리다이렉트하는 MP4를 스트리밍하세요.
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으로 넘기고, 영상이 준비될 때까지 폴링한 뒤 릴리스에 첨부하세요.
Airtable 자동화 영상 생성 API: 레코드마다 영상 하나
Airtable Run a script 액션으로 callback_url과 함께 POST /v1/videos를 호출하고, 두 번째 자동화에서 Sume 웹훅을 받아 URL을 저장하세요.
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으로 확인하세요.
Slack 영상 생성 봇: Sume API로 만드는 슬래시 커맨드
Slack 슬래시 커맨드에 3000 ms 안에 응답하고 callback_url과 함께 POST /v1/videos를 제출한 뒤, Sume 웹훅이 오면 response_url로 URL을 게시하세요.
Discord 봇 AI 영상 생성: 응답을 미룬 뒤 수정하기
Discord 인터랙션에 3초 안에 지연 응답을 보내고 callback_url과 함께 POST /v1/videos를 제출한 뒤, Sume Job 웹훅이 오면 응답을 수정하세요.
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로 핸들러를 노출하고, 서명된 테스트를 보낸 뒤, 실제 이벤트를 다시 보내세요.
Sume Agent Completions 도구로 CrewAI 영상 생성
영상 브리프를 지출 상한과 함께 Sume Agent Completions로 넘기는 BaseTool을 CrewAI 에이전트에 주고, agent.run을 읽어 완성된 영상을 받으세요.
가상 착용(Virtual Try-On) 영상 API: 사람에게 옷 입히기
Sume API로 가상 착용 영상을 만들려면 사진을 담아 sume-virtual-try-on이나 sume-virtual-fitting을 호출하거나, 스틸을 만든 뒤 움직임을 입히세요.
제품 사진 영상 변환 API: SKU 사진으로 만드는 이커머스 클립
Sume API로 제품 사진을 영상으로 만들려면 제품에 맞는 카탈로그 Format을 호출하거나, 사진을 첫 프레임으로 넣어 움직임을 입히세요.
AI 제품 사진 API: 스플래시·드립·푸어링 샷
Sume 카탈로그 Format 여섯 개가 뷰티 제품의 스플래시, 드립, 푸어링, 짜기, 텍스처 스틸을 만듭니다. 그 밖의 제품은 /v1/images로 팩샷을 편집하세요.
비포 애프터 영상 생성 API: 변화를 드러내는 장면 만들기
Sume API로 비포 애프터 영상을 만들려면 sume-before-after Format을 호출하거나, 첫·마지막 프레임을 지정한 클립을 만들거나, 스틸 두 장을 Timeline 와이프로 이으세요.
로고 애니메이션 API: 브랜드 마크를 아이덴트·엔드 카드로
Sume API로 로고 애니메이션을 만들려면 마크를 첨부해 sume-logo-motion-design을 호출하거나 첫 프레임으로 넣어 직접 움직이게 하고, 엔드 카드로 붙이세요.
AI 제품 광고 영상 생성 API: Format 또는 직접 만들기
Sume API로 제품 광고를 만들려면 sume-product-commercial이나 sume-cinematic-studio-commercial을 실행하거나, /v1/videos에서 클립을 생성하세요.
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
여러 제품 사진을 AI 이미지 한 장으로 합치려면 SKU마다 팩샷을 Sume의 sume-editorial-product-set Format에 첨부하거나 POST /v1/images로 보내세요.