가이드
Sume 가이드: API, 포맷, 에이전트, 모델, 미디어 도구, 요금을 다룹니다. 답마다 날짜와 출처를 붙였습니다.
Python TTS API: 요청, 폴링, MP3 저장하기
Python에서 Requests로 텍스트 음성 변환 API를 호출하세요. 텍스트와 음성을 POST하고 Job을 폴링한 뒤 MP3를 저장하는 Sume TTS 1.0 전체 스크립트입니다.
JavaScript TTS API: Node.js에서 MP3로 저장하기
서버의 JavaScript 코드에서 텍스트 음성 변환(TTS) API를 호출하세요. Node.js에서 Sume SDK로 텍스트를 제출하고, Job을 기다린 뒤 MP3를 저장합니다.
AI 음악 프롬프트 예시: 템플릿과 브리프 6가지
좋은 AI 음악 프롬프트는 브리프처럼 읽힙니다. 분위기, 장르, BPM, 조성, 악기, 순간 하나, 시대를 담으세요. 템플릿 하나와 고쳐 쓸 수 있는 예시 여섯 가지를 소개합니다.
이미지로 음악 만드는 AI: 사진으로 트랙 생성하기
이미지로 음악을 만드는 AI는 사진을 트랙의 입력으로 씁니다. Sume에서는 텍스트 프롬프트와 함께 image_url을 Music Router로 보내며, 가격은 그대로입니다.
AI로 영상에 맞는 음악 만들기: 생성 후 편집본에 맞추기
AI로 영상에 맞는 음악을 만들려면 편집본을 음악 브리프로 설명하고, 영상의 스틸을 보내고, 영상 길이만큼 요청한 뒤 트랙을 영상에 맞추세요.
AI 징글 생성기: 텍스트로 팟캐스트 인트로 만들기
텍스트 브리프로 징글이나 팟캐스트 인트로를 만드세요. 프롬프트로 길이를 요청한 뒤, 오디오 split으로 트랙을 정확한 초에 맞춰 자릅니다.
긴 오디오 파일 텍스트 변환: 10분 단위로 나눠 전사하기
API로 긴 오디오를 전사하려면 최대 10분 길이의 조각으로 나눠 조각마다 전사한 뒤, 각 조각의 시작 시각을 그 조각의 타임스탬프에 더하세요.
일괄 전사 API: 여러 오디오 파일을 텍스트로 변환하기
API 일괄 전사는 파일마다 음성 인식 Job을 하나씩 보내는 루프입니다. 키는 파일 ID로 만들고, 결과는 웹훅이나 폴링으로 모읍니다. Sume에서 동작하는 방식을 설명합니다.
영상 텍스트 변환 API: 오디오 트랙을 보내 전사하기
API로 영상을 텍스트로 변환하려면 오디오 트랙을 음성 인식으로 보내세요. Sume에서는 Sume에 호스팅된 클립을 검사하거나, 직접 가진 파일의 오디오를 STT 1.0으로 보냅니다.
음성 인식 API로 오디오의 언어를 감지하는 방법
오디오 파일에서 말하는 언어를 감지하려면 언어 힌트 없이 음성 인식을 실행한 뒤, 결과에서 감지된 언어 코드와 신뢰도를 읽으세요.
한국어 음성 인식(STT) API: 한국어 오디오 전사하기
API로 한국어 음성을 텍스트로 전사하려면 오디오 URL을 language_code ko와 함께 보내거나 자동 감지에 맡기세요. 단어별 타이밍이 담긴 전사문을 받습니다.
말하기 속도 계산 방법: 분당 단어 수(WPM) 구하기
말하기 속도는 말한 단어 수를 분 단위 발화 시간으로 나눈 값입니다. 음성 인식의 단어별 타임스탬프로 녹음 전체나 문장마다 두 값을 모두 잴 수 있습니다.
YouTube 챕터 생성기: 전사문으로 타임스탬프 만들기
YouTube 챕터 생성기는 전사문을 00:00부터 시작하는 타임스탬프와 제목으로 바꿉니다. 문장 타이밍은 음성 인식에서, 주제가 바뀌는 지점은 LLM에서 얻습니다.
Python 음성 인식(STT): 오디오를 타임스탬프와 함께 텍스트로
Python에서 Requests로 음성을 텍스트로 변환하세요. 오디오 URL을 보내고 Job을 폴링한 뒤 전사문과 단어별 타임스탬프를 읽는 Sume STT 1.0 스크립트입니다.
JavaScript 음성 인식 API: Node.js에서 오디오를 텍스트로
서버의 JavaScript 코드에서 음성 인식 API를 호출하세요. Node.js에서 Sume SDK로 오디오 파일 URL을 보내고, Job을 기다린 뒤 텍스트를 읽습니다.
n8n 오디오 텍스트 변환: HTTP Request 노드로 전사하기
n8n에서 오디오를 텍스트로 전사하세요. HTTP Request 노드로 녹음 파일의 공개 URL을 보내고, Job이 끝날 때까지 Wait 노드를 반복한 뒤 텍스트를 매핑합니다.
오디오 파일을 영어로 번역하기: 전사, 번역, 음성 합성
오디오를 영어로 번역하는 세 단계입니다. 언어 감지와 함께 녹음을 전사하고, 텍스트를 번역한 뒤, 필요하면 TTS로 영어 음성을 만듭니다.
Claude로 오디오를 텍스트로 변환하기: MCP 음성 인식 도구
Claude로 오디오를 텍스트로 전사하려면 MCP로 음성 인식 도구를 연결하고 공개 오디오 URL을 건넨 뒤, 전사문과 단어별 타이밍을 읽으세요.
Claude 텍스트 음성 변환(TTS): MCP로 오디오 파일 만들기
Claude에서 텍스트 음성 변환을 하려면 MCP로 TTS 도구를 연결하세요. Claude가 대본과 음성을 보내고, 오디오 파일 링크를 돌려줍니다.
AI 영상 생성을 코드로 자동화하는 방법
AI 영상 생성을 자동화하려면 잘 나오는 브리프를 레시피로 저장하고, 이벤트·목록·스케줄에 맞춰 코드에서 시작한 뒤, 완성된 영상은 웹훅으로 받으세요.
개인화 영상 대량 제작: 레시피 하나, 사람마다 실행 하나
개인화 영상을 대량으로 만들려면 레시피 하나를 고정하고, 사람마다 정보를 입력으로 넘겨 요청당 최대 100명씩 묶은 뒤, ID로 영상을 다시 연결하세요.
AI로 YouTube Shorts 자동화하기: 생성 후 업로드
AI로 YouTube Shorts를 자동화하는 일은 두 가지 작업입니다. 스케줄에 맞춰 세로 영상을 생성하고, 여러분의 코드에서 YouTube Data API로 업로드하세요.
블로그 글 영상 변환 AI: 새 글마다 영상 만들기
블로그 글 영상 변환 AI는 글을 내레이션 영상으로 만듭니다. 자동화하려면 새 글의 텍스트를 지출 상한, 글에 묶인 키와 함께 영상 에이전트에 보내세요.
API 키가 노출됐다면? 먼저 폐기하고 사용 내역 확인하기
노출된 API 키는 폐기하기 전까지 누구나 쓸 수 있습니다. 새 키로 교체하고 이전 키를 폐기한 뒤, 그 키의 최근 사용과 지출, 여러분의 Job을 확인하세요.
여러 사람이 같은 API 키를 써도 되나요?
쓸 수는 있지만, 그러면 키의 요청 한도와 사용 기록, 폐기까지 함께 나누게 됩니다. 사람이나 서비스마다 키를 따로 주고, 그래도 공유되는 것이 무엇인지 알아 두세요.
AWS Step Functions 콜백 대기로 AI 영상 실행 기다리기
Step Functions 실행을 .waitForTaskToken으로 멈춰 AI 영상 실행이 끝날 때까지 기다리세요. 태스크 토큰을 보관해 두었다가 Sume 웹훅이 오면 돌려주면 됩니다.
Temporal 워크플로 시그널: AI 영상 웹훅에서 보내기
영상 작업은 Temporal 액티비티에서 시작하고, 웹훅 수신기가 워크플로 ID로 보내는 시그널을 기다리세요. 시그널과 별개로 실행을 읽는 타이머도 두세요.
Airflow HTTP 센서로 AI 영상 Job 완료 기다리기
Airflow의 HttpOperator로 AI 영상 Job을 제출한 뒤, Job 상태가 completed가 되면 통과하는 reschedule 모드의 HttpSensor로 기다리세요.
Durable Functions 외부 이벤트 대기: AI 영상 웹훅
Durable Functions 오케스트레이터는 웹훅 함수가 발생시키는 외부 이벤트를 기다리고, POST가 오지 않는 실행에 대비해 지속성 타이머와 경쟁시킵니다.
Azure Functions 타임아웃: AI 영상 Job은 기다리지 마세요
Azure Functions는 Consumption 플랜에서 기본 5분 뒤에 타임아웃되고, HTTP 트리거는 230초 안에 응답해야 합니다. 영상 Job은 콜백과 함께 제출하세요.
FastAPI 오래 걸리는 작업: 202와 Job ID로 응답하기
FastAPI에서 오래 걸리는 작업은 요청을 열어 둔 채 기다리지 말고 Job ID와 함께 202로 응답하세요. AI 영상 Job이라면 작업은 Sume가 하고 결과는 웹훅으로 옵니다.
Kubernetes CronJob 동시성 정책: 유료 API 작업용
Allow, Forbid, Replace? CronJob의 concurrencyPolicy는 Job을 다룰 뿐 Job이 시작한 API 작업은 다루지 않습니다. 유료 API 호출에는 멱등성 키를 더하세요.
NestJS raw body로 웹훅 서명 검증하기
NestJS에서는 NestFactory.create에 rawBody: true를 넘기고, Buffer인 req.rawBody로 웹훅 서명을 검증하세요. 100kb JSON 한도도 함께 올리세요.
Spring Boot 웹훅: HMAC-SHA256 서명 검증하기
Spring Boot 웹훅은 본문을 byte[]로 받아 타임스탬프와 원본 바이트에 대한 HMAC-SHA256을 계산하고, 각 sume-v1 항목을 상수 시간으로 비교합니다.
C# 웹훅 수신기 예제: ASP.NET Core와 HMAC-SHA256
ASP.NET Core로 만드는 C# 웹훅 수신기: 원본 본문을 Stream으로 바인딩하고, 타임스탬프와 바이트에 HMAC-SHA256을 계산해 각 sume-v1 항목을 고정 시간으로 비교하세요.
무료 웹훅 테스터: 코딩 전에 웹훅이 보내는 내용 보기
무료 웹훅 테스터는 공개 HTTPS URL을 주고, 들어온 요청마다 헤더와 본문을 보여 줍니다. Sume의 테스트 보내기(Send test)를 그 URL로 보내면 서명된 페이로드를 볼 수 있습니다.
EventBridge로 Lambda 함수를 스케줄에 따라 실행하는 방법
EventBridge Scheduler로 cron 또는 rate 스케줄에 따라 Lambda 함수를 호출하세요. 매일 만드는 AI 영상이라면 예약 시각으로 만든 키로 실행을 시작하고 바로 반환하세요.
Cloudflare Workers cron job: AI 영상 예약 실행
Cron Trigger와 scheduled() 핸들러를 추가하면 Worker가 일정에 따라 실행됩니다. AI 영상이라면 실행의 키를 scheduledTime으로 만들고 바로 반환하세요.
Supabase cron Edge Function: AI 영상 예약 실행
pg_cron과 pg_net으로 Supabase Edge Function을 예약 실행하고, 영상 API 키는 함수 시크릿에 두고, 날짜로 만든 키로 하루에 실행 하나를 시작하세요.
GitLab 파이프라인 스케줄: 매일 밤 AI 영상 작업 실행
GitLab 예약 파이프라인을 매일 밤 실행해 날짜 기반 Idempotency-Key로 AI 영상을 시작하고, 실행 마감보다 긴 작업 타임아웃 안에서 폴링하세요.
Python으로 URL의 파일을 S3 버킷에 업로드하는 방법
URL의 응답을 임시 파일 없이 boto3의 upload_fileobj로 바로 스트리밍하세요. 생성된 영상이라면 웹훅을 받을 때 복사하고 바이트를 확인하세요.
React Query 폴링: 작업이 끝나면 refetchInterval 멈추기
React Query의 refetchInterval로 영상 Job을 폴링하세요. 백엔드를 호출하고, API가 제안하는 간격만큼 기다리다가, Job이 종료되면 false를 반환하면 됩니다.
Axios retry: 멱등성 키로 POST 안전하게 재시도하기
axios-retry로 네트워크 오류, 429, 5xx를 지수 백오프로 재시도하고, 유료 POST는 Idempotency-Key가 있을 때만 재시도하세요.
AI로 사진을 말하게 하는 방법: 음성 먼저, 그다음 립싱크
사진은 두 단계로 말하게 할 수 있습니다. 텍스트를 음성으로 바꾼 뒤, 그 오디오에 맞춰 사진을 립싱크하세요. Sume에서는 TTS 1.0 다음 VEED Fabric 1.0을 씁니다.
AI로 나를 클론하는 방법: 내 얼굴과 내 목소리
AI로 나를 클론하려면 내 얼굴 사진과 내 목소리 클론을 짝지으세요. Sume에서는 목소리를 클론하고, TTS 1.0으로 말하게 한 뒤, Fabric으로 립싱크합니다.
AI 아바타 언어: 아바타는 어떤 언어로 말할 수 있나요?
Sume의 Avatar 1.0 말하는 영상은 현재 영어로만 말합니다. 스페인어, 힌디어, 한국어라면 TTS 1.0으로 음성을 만든 뒤 립싱크하세요.
AI 립싱크 번역: 아바타 영상을 더빙하는 방법
Sume는 기존 영상의 입 모양을 다시 맞추지 못합니다. 아바타 영상을 더빙하려면 대본을 번역하고, TTS 1.0으로 읽힌 뒤, Fabric으로 얼굴을 립싱크하세요.
AI 아바타 언어 튜터: 천천히 말하고 자막이 있는 레슨 영상
AI 아바타 언어 튜터 영상 만들기: 레슨 문장마다 TTS 1.0으로 천천히 읽히고, Fabric으로 튜터 아바타를 립싱크한 뒤, 클립마다 자막을 입히세요.