영상 API 미디어 입출력: 공개 URL 입력, Sume URL 출력
Sume 생성 요청은 미디어를 정해진 필드의 공개 HTTPS URL로 받으며 별도 업로드 단계가 없습니다. 결과는 저장해 둘 Sume 호스팅 media.sume.com URL로 돌아옵니다.
개발자
Sume API로 개발할 때 필요한 글입니다. API 키와 호스트, 작업과 실행, 폴링, 웹훅, 멱등성, 오류와 요청 한도, SDK, CLI, MCP 인증을 다룹니다.
먼저 읽을 글: Sume API 빠른 시작: 다섯 단계로 첫 영상 생성 호출하기
Sume CLI로 터미널에서 아바타 영상 생성하기
Sume CLI를 설치하고 브라우저로 로그인한 뒤 말하는 아바타 영상을 제출하세요. Image, Video, Music 1.0에는 아직 CLI 제출 명령어가 없습니다.
Sume API 키 동작 방식: 스코프, 인증 헤더, 호스트, 교체
Sume API 키는 워크스페이스 단위 시크릿으로, Bearer나 x-api-key 중 하나로만 보냅니다. 스코프는 생성 시 고정되고, 키는 발급된 호스트에서만 동작합니다.
Sume 영상 Job 동시성과 큐: 한도와 queue_full
Sume는 유효한 유료 Job을 queued로 받아 요금제 동시성 한도 안에서 실행합니다. 제출이 429 queue_full로 실패하는 것은 큐까지 가득 찼을 때뿐입니다.
Sume API 오류와 요청 한도: 오류 코드, 429, 재시도 시점
Sume API 오류는 안정적인 코드와 request id를 담은 하나의 봉투로 옵니다. 읽기와 쓰기는 분당 예산이 따로 있고, queue_full은 요청 한도가 아닙니다.
Sume 영상 실행용 서명된 웹훅: 이벤트, 재시도, 검증
Format·Action·Agent Completion 실행이 완료되거나 실패하면 Sume가 HMAC-SHA256 서명 POST를 한 번 보냅니다. 원본 본문을 검증하고 request_id로 중복을 제거하세요.
Claude Code·Cursor에서 영상과 이미지를 만드는 MCP 서버
Claude Code와 Cursor에서 영상과 이미지를 만드는 MCP 서버 Sume, fal, Replicate, Runway, Higgsfield의 엔드포인트, 로그인, 과금, 설정을 비교합니다.