Vercel 함수 타임아웃과 영상 생성: 웹훅을 쓰세요
Vercel Function은 기본적으로 300초에 멈추지만 Sume 영상 실행은 몇 분이 걸립니다. webhook_url과 함께 제출하고 바로 반환한 뒤, 서명된 POST를 검증하세요.
연동
자동화 플랫폼, 서버리스 함수, 에이전트 프레임워크, MCP 클라이언트에서 Sume을 호출하는 방법을 다룹니다. 전용 커넥터 없이 HTTPS 호출이나 원격 MCP를 씁니다.
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을 읽어 완성된 영상을 받으세요.
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 동의가 무엇을 부여하는지 확인한 뒤, 채팅이 호출할 도구를 고르세요.
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를 돌려주면 됩니다.
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로 비교하세요.