가이드
Sume 가이드: API, 포맷, 에이전트, 모델, 미디어 도구, 요금을 다룹니다. 답마다 날짜와 출처를 붙였습니다.
Reference-to-Video API: 이미지·영상·오디오 레퍼런스
POST /v1/videos에 input_references를 보내 레퍼런스 이미지, 영상, 오디오로 클립의 방향을 잡으세요. 유형별로 이를 받는 Sume 영상 모델과 받는 개수를 정리했습니다.
AI 영상 편집 API: 프롬프트로 영상 편집하기(video-to-video)
POST /v1/video-router/generate에 gemini-omni-flash-1.1과 video_url을 보내 기존 클립을 프롬프트로 편집하세요. 편집 모드의 입력, 거부, 비용을 다룹니다.
Sume의 GPT Image 2.5 API: 품질·크기·마스크·레퍼런스
Sume의 POST /v1/images로 ChatGPT Image 2.5를 호출하세요. max까지의 품질, 커스텀 픽셀 크기, 마스크, 최대 16장의 레퍼런스 이미지를 쓸 수 있습니다.
Text-to-Video API 오디오 생성: 소리를 만드는 영상 모델
Sume의 POST /v1/videos는 카탈로그에 generate_audio가 설정된 모델에서 소리를 만듭니다. 모델별 오디오 생성 방식(항상·선택·없음)과 거부되는 값을 정리했습니다.
AI 영상 생성 API 길이 제한: 클립당 최대 30초
Sume에서 30초 클립을 만드는 모델은 seedance-2.5(4–30초)와 wan-3.0(2–30초)이고, 다른 모델은 15초 이하입니다. 모델별 한도, 오류, 더 길게 만드는 법을 정리했습니다.
세로형 9:16 영상 생성 API: 모델별 화면 비율
세로 영상은 POST /v1/videos에 aspect_ratio "9:16"을 보내세요. 9:16, 1:1, 21:9를 지원하는 Sume 모델과 픽셀 크기가 400을 반환하는 이유를 정리했습니다.
4K AI 영상 생성 API: 모델별 해상도, 360p부터 4K까지
Sume에서 4K는 gemini-omni-flash-1.1을 지정해 resolution 4K로 요청하세요. minimax-h3는 2K나 4K로 업스케일합니다. 영상 모델별 해상도와 가격 영향을 다룹니다.
Gemini Omni Flash 1.1 API: 텍스트·이미지·레퍼런스 영상
Sume에서 Gemini Omni Flash 1.1을 gemini-omni-flash-1.1로 호출하세요. 텍스트·이미지·레퍼런스로 360p부터 4K까지 3–10초 클립을 네이티브 오디오와 함께 만듭니다.
MiniMax H3·H3 Max 영상 API: 네이티브 768p·스테레오 오디오
Sume의 MiniMax H3·H3 Max(minimax-h3, minimax-h3-max)는 네이티브 480p·768p(H3 Max는 1080p도)로 5–15초 클립을 만들며, 스테레오 오디오가 항상 들어갑니다.
Sume의 Nano Banana Pro API: 4K 등급·화면 비율·편집
Sume의 POST /v1/images로 Nano Banana Pro나 Nano Banana 2를 호출하세요. 512~4K 해상도 등급, 네이티브 화면 비율, 최대 10장의 레퍼런스 이미지를 쓸 수 있습니다.
립싱크 API: 이미지와 오디오로 말하는 클립 만들기
스틸 이미지와 Sume에 호스팅된 오디오를 VEED Fabric 1.0이나 MiniMax H3 Max Lip Sync로 보내 말하는 클립을 받으세요. 입력, 제한, 초당 요금을 다룹니다.
Sume의 이미지 생성 API 모델: 편집·레퍼런스·마스크
Sume의 이미지 생성 API에는 모델이 17개 있습니다. 레퍼런스 이미지로 편집하는 모델, 모델별 레퍼런스 수, 텍스트 전용 모델, 마스크를 받는 모델을 확인하세요.
AI 이미지 생성 API 화면 비율: 4:5, 커스텀 크기, auto
Sume의 POST /v1/images에 aspect_ratio나 image_size를 보내세요. 4:5를 받는 모델, 커스텀 픽셀 크기를 받는 모델, 편집에서 auto를 보낼 때를 정리했습니다.
영상 생성 모델 목록 API: GET /v1/videos/models
GET /v1/videos/models는 Sume의 모든 영상 모델을 해상도, 화면 비율, 길이, 프레임·레퍼런스 유형, 오디오 여부, 가격 SKU와 함께 보여 줍니다.
Wan 3.0 API: 2–30초 AI 영상, 오디오·프레임·레퍼런스
Sume에서 Wan 3.0을 wan-3.0으로 호출하세요. 프롬프트, 첫 프레임과 마지막 프레임, 또는 이미지·영상·오디오 레퍼런스로 480p, 720p, 1080p의 2–30초 클립을 만듭니다.
Sume의 Seedream 4.5 API: 편집·커스텀 크기·5 Lite
Sume의 POST /v1/images로 Seedream 4.5, 5.0 Lite, 4.0을 호출하세요. 최대 10장의 레퍼런스 이미지로 편집하고 커스텀 픽셀 크기를 지정할 수 있습니다.
4K AI 이미지 생성 API: 해상도, 품질, 이미지 수
Sume의 POST /v1/images에서 4K 등급을 나열하는 모델은 Nano Banana 2와 Pro뿐입니다. 모델별 해상도 등급, 품질 단계, 호출당 이미지 수, 출력 형식을 확인하세요.
Sume는 어떤 AI 모델을 지원하나요? API별 모델 ID 전체
Sume는 영상 모델 11개, 이미지 모델 17개, Music·TTS Router ID, Avatar 1.0, 립싱크 모델을 지원합니다. 모든 ID를 엔드포인트별로 정리했습니다.
모션 컨트롤 API: 드라이빙 영상으로 이미지 움직이기
Sume의 Kling 3.0 Motion Control은 최대 30초 길이의 드라이빙 영상에서 움직임을 가져와 스틸 이미지를 움직입니다. 요청 필드, 제한, 가격을 다룹니다.
텍스트 음성 변환(TTS) API: 아바타 목소리로 음성 생성하기
Sume의 텍스트 음성 변환 API인 POST /v1/tts-1.0/generate는 준비된 아바타의 목소리로 최대 20,000자를 읽으며, 단어별 타임스탬프와 문장별 오디오 조각도 제공합니다.
API로 영상에 배경 음악 넣기: 루프, 페이드, 더킹
Sume Timeline 1.0 렌더에 사운드트랙을 더하면 Sume에 호스팅된 음악을 음성 스파인 아래에 믹싱할 수 있습니다. 레벨, 루프, 페이드아웃, 말소리 아래 더킹을 설정하세요.
Sume API로 가로 영상을 세로 9:16으로 변환하기
영상 필터로 Sume에 호스팅된 16:9 클립에서 9:16 영역을 잘라 내거나, 클립을 1080×1920 Timeline 렌더에 넣고 cover, contain, blur 중 하나로 맞춥니다.
Sume API로 긴 영상을 짧은 클립으로 나누기
영상 검사로 Sume에 호스팅된 영상을 전사해 자를 지점을 찾고, 영상 트림으로 구간마다 잘라 낸 뒤 짧은 클립마다 크롭과 자막을 적용합니다.
Sume API로 영상의 오디오를 교체하거나 제거하기
영상 트림의 audio: drop으로 클립의 오디오를 제거하거나, Timeline 1.0에서 Sume에 호스팅된 새 스파인 위에 클립을 렌더링해 교체하거나, gain_db로 레벨을 다시 맞추세요.
영상 전환 효과(트랜지션) API: 크로스페이드·와이프·슬라이드
Sume Timeline 1.0 렌더의 클립 사이에 페이드, 와이프, 슬라이드, 디졸브 트랜지션을 넣을 수 있습니다. 각각 최대 1초이고 정수 프레임으로 스냅되며, 연속으로는 최대 8개입니다.
이미지 슬라이드쇼 영상 API: 이미지와 음악으로 MP4 만들기
Timeline 1.0으로 Sume에 호스팅된 이미지를 슬라이드쇼 MP4로 만드세요. 스틸은 영상 슬롯으로, 길이는 무음 스파인으로, 음악은 루프되는 사운드트랙으로 지정합니다.
ffmpeg 필터 API: Sume 영상 필터 허용 목록과 검사
POST /v1/video-filter로 Sume에 호스팅된 클립에 허용 목록의 ffmpeg 필터를 적용합니다. 허용된 이름, filtergraph 규칙, 무료 검사, 인코딩 설정을 정리했습니다.
API로 영상의 마지막 프레임을 추출해 AI 클립 잇기
Sume에 호스팅된 클립의 길이와 fps를 무료로 프로브하고, 영상 프레임으로 마지막 프레임을 PNG로 추출한 뒤, 다음 first_frame으로 /v1/videos에 넘깁니다.
한국어 자막 API: 두부 글자 없는 한글 자막 스타일과 폰트
Sume 자막 API로 한국어 자막을 입히려면 한글을 지원하는 스타일과 폰트를 고르세요. 한국어 문구가 두부 글자가 아닌 한글 서체로 렌더링됩니다.
자막 자동 생성 API: 전사하고 문구를 고친 뒤 입히기
Sume로 자막을 자동 생성하세요. 영상 검사로 클립을 전사하고 문구를 고친 뒤, script_text 정렬로 영상에 자막을 입힙니다.
자막 커스터마이즈 API: 색, 위치, 크기, 줄당 단어 수
Sume의 design 객체로 영상에 입히는 자막을 커스터마이즈하세요. punch와 tiktok-green을 뺀 모든 스타일에서 색, 위치, 크기, 구절당 단어 수를 덮어씁니다.
Sume API로 영상의 프레임 레이트나 해상도 바꾸기
영상 트림의 output 필드나 영상 필터의 scale, fps 필터로 Sume에 호스팅된 클립의 크기와 fps를 맞추고, Timeline이 출력 프레임 레이트를 고르는 방식을 알아봅니다.
Sume API로 영상의 길이, 해상도, fps 확인하기
POST /v1/video-inspect에 frames: false를 보내면 Sume 호스팅 클립의 길이, 너비, 높이, fps, 오디오 유무, 코덱, HDR을 무료로 프로브합니다.
단어별 타임스탬프를 주는 음성 인식 API: Sume STT 1.0
공개 HTTPS 오디오 URL을 POST /v1/stt-1.0/transcribe로 보내면 단어마다 시작·끝 초가 붙은 전사문을 받고, 원하면 문장 구간도 받을 수 있습니다.
배경 제거 API: Sume RMBG 1.0으로 투명 PNG 만들기
공개 HTTPS 이미지 URL을 POST /v1/rmbg-1.0/remove로 보내면 알파 채널이 있는 PNG를 돌려받습니다. 크기와 관계없이 이미지당 요금은 하나입니다.
AI 이미지 업스케일러 API: Sume로 이미지를 최대 4배 확대
POST /v1/image-upscale-1.0/upscale은 공개 HTTPS 이미지 URL과 upscale_factor 1–4(기본값 2)를 받아 PNG·JPG·WebP 중 하나를 반환합니다.
AI 영상 업스케일러 API: 배율, 향상 등급, 비용
POST /v1/video-upscale-1.0/upscale은 공개 HTTPS 영상 URL, scale_ratio 1.1–4, fast·standard·pro 중 하나의 향상 등급을 받습니다.
Sume Job 실행 전에 AI 영상 생성 비용 추정하기
결제 전에 Sume에서 AI 영상 비용을 확인하세요. 공개 요율, GET /v1/catalog 추정치, 과금되지 않는 plan 검사, MCP dry run, 지출 상한을 다룹니다.
60초보다 긴 AI 아바타 영상을 만드는 방법
Sume 아바타 영상 Job 하나가 다루는 길이는 추정 4-60초입니다. 더 긴 영상은 스크립트를 나눠 파트별로 렌더링한 뒤 Timeline 1.0으로 이어 붙이세요.
Sume API로 말하는 아바타 영상에 B-roll 넣기
Avatar 1.0 클립의 음성을 Timeline 스파인 하나로 쓰고 B-roll 슬롯으로 컷어웨이하세요. 돌아올 때 source_in을 start와 같게 두면 입 모양이 말과 어긋나지 않습니다.
AI 아바타 대화 영상 API: 두 화자가 주고받는 대화
Sume 아바타 영상 Job은 아바타 하나만 해석하므로, 두 사람의 대화는 차례마다 Job을 하나씩 만들어 Timeline 1.0으로 말하는 순서대로 이어 붙입니다.
API로 제품과 배경을 넣은 AI 아바타 영상 만들기
Sume Avatar 1.0 말하는 영상에 product_image와 장면 프롬프트나 사진을 넣고, 전체 렌더 전에 프리뷰로 첫 프레임을 확인하세요.
스톡 AI 아바타 API: 말하는 영상에 바로 쓸 아바타 찾기
POST /v1/avatar-catalog/search로 Sume 아바타 카탈로그를 검색해 준비된 공개 아바타를 고르고, 아바타를 만들 필요 없이 그 handle을 말하는 영상에 넘기세요.
AI 아바타 영상 API 요금: 초당·분당 비용
Sume는 AI 아바타 영상을 품질 등급별 초당 요율로 청구하며, 제품 이미지를 보내면 요율이 따로 적용됩니다. standard, plus, max의 분당 비용을 정리했습니다.
영상 생성 Job 상태 API 폴링하기: Sume의 /v1/jobs
terminal이 true일 때까지 GET /v1/jobs/{id}/status를 next_poll_after_seconds 간격으로 폴링하고, result_ready가 true면 /result를 읽으세요.
영상 생성 API 동기 vs 비동기: Sume의 네 가지 제출 모드
Sume의 제출 모드는 async, sync, subscribe, webhook입니다. sync와 subscribe는 최대 30초만 기다리므로, 영상은 async로 제출해 폴링하거나 웹훅을 받으세요.
Sume TypeScript SDK 빠른 시작: 설치·클라이언트·오류·재시도
@sume-com/sdk를 설치하고 createSumeClient로 클라이언트 하나를 만든 뒤, throw 대신 오류를 반환하는 타입 지정 오퍼레이션을 호출하세요. 재시도는 기본으로 들어 있습니다.
실패한 AI 영상 생성도 크레딧이 차감되나요? 예약·확정·환불
아닙니다. Sume는 제출 시 Job의 예상 USD 비용을 예약(선차감)하고, 완료될 때만 사용량을 확정하며, Job이 실패하거나 취소되면 예약을 해제하거나 환불합니다.