Sume란 무엇인가요? 영상 에이전트 플랫폼과 API, 요금
Sume는 영상 에이전트 플랫폼입니다. 채팅에서 에이전트에게 브리프를 주고, 레시피를 Format으로 저장해 백엔드에서 API 하나로 호출합니다. 제품 표면과 요금을 정리했습니다.

Sume는 영상 에이전트 플랫폼입니다. 사람들은 채팅에서 에이전트와 함께 영상을 만들고 다듬은 뒤, 그 결과를 Format이라는 재사용 가능한 레시피로 저장하고, 자체 백엔드에서 HTTP로 그 Format을 호출합니다. 이미지, 영상, 아바타, 텍스트 음성 변환, 타임라인 같은 개별 생성 도구도 HTTP API로 제공됩니다.
이 정의는 2026-09-27에 확인한 Sume 기초에서 가져왔으며, 공개 사이트는 제품에 "Video Agent API built for automation."(자동화를 위한 영상 에이전트 API)이라는 제목을 붙이고 있습니다. 이 글은 문서와 사이트가 Sume의 제공 기능이라고 밝힌 것만 나열합니다. 그 바탕이 되는 개념은 영상 에이전트란 무엇인가요?에서 설명합니다.
Sume는 무엇을 제공하나요?
Sume 기초의 제품 맵은 다음 표면을 나열합니다.
- Agents:
www.sume.com/agents의 채팅 UI로, 사람이 브리프를 쓰고, 지출을 승인하고, 아티팩트를 확인하고, 레시피를 저장하는 곳입니다. - Formats: 백엔드가 handle과 slug로 호출하는 저장된 레시피입니다. 실행할 때마다 새 샌드박스를 띄우고, 레시피를 로드하고, 생성 도구를 갖춘 에이전트를 실행한 뒤, 아티팩트와 선택적 구조화 JSON을 돌려줍니다. 바로 쓸 수 있는 Formats by Sume는
sumehandle로 호출합니다. - Agent Completions와 Scheduled: 같은 에이전트가 백엔드에서 보낸 임시 작업을 수행하거나, 저장된 작업을 정해진 주기로 실행합니다.
- Models:
POST /v1/videos(카탈로그 모델 또는sume/auto),POST /v1/images, Sume Avatar 1.0, Music Router 같은 단일 생성 엔드포인트입니다. - TypeScript SDK인
@sume-com/sdk, 그리고 키, Job, 사용량, 결제를 다루는 대시보드가 있습니다.
Sume의 도메인과 진입점은 무엇인가요?
문서는 Format API를 대부분의 파트너가 연동해야 하는 표면이라고 설명합니다. 모델은 호출 한 번만 필요하고 다른 것은 필요 없을 때 쓰는 보조 구성 요소입니다. CLI와 호스팅 MCP도 있고 여전히 동작하지만, 문서는 둘 다 현재 주 경로가 아니라고 말합니다.
| 진입점 | 주소 | 설명 |
|---|---|---|
| Developer API | https://api.sume.com/v1 | 워크스페이스 범위에서 키로 인증하는 공개 API |
| OpenAPI | https://api.sume.com/reference/json | 라이브 스키마. 필드 정의의 기준 원본 |
| 미디어 | https://media.sume.com | 퍼스트파티 생성 미디어 아티팩트 |
| Agents | https://www.sume.com/agents | 채팅 기반 작성 UI |
| 대시보드 | https://www.sume.com/dashboard | API 키, Job, 사용량, 결제와 구독 |
| 호스팅 MCP | https://mcp.sume.com/mcp | 원격 MCP 엔드포인트. 현재 주 경로는 아님 |
| 문서 | https://docs.sume.com | 가이드와 API 레퍼런스 |
개발자는 Sume를 어떻게 호출하나요?
대시보드에서 API 키를 만들고, 서버 쪽 환경에서 Authorization: Bearer 또는 x-api-key로 보내세요. 키에 워크스페이스가 담겨 있으므로 요청 본문에 워크스페이스 ID를 보내지 않습니다. Format 실행은 POST /v1/formats/{handle}/{slug}/runs 한 번이고 영수증으로 응답하며, 그다음에는 서명된 웹훅을 받거나 폴링합니다. 첫 호출은 Sume API 빠른 시작에서, 레시피는 Sume Format이란?에서 다룹니다.
Sume는 요금을 어떻게 청구하나요?
요금제는 Free $0, Pro 월 $40, Startup 월 $120, Scale 월 $400이며, 맞춤 조건이나 인보이스 결제는 Enterprise가 다룹니다. 사용량은 기본적으로 모델별 공개 요율에 5.5% 에이전트 수수료를 더해 청구되며, 영상 생성, Sume Agent, Format, API가 모두 잔액 하나에서 차감됩니다.
- API 요금은 공개된 종량제 요율표이며, 가격의 기준이 되는 원본입니다.
- 크레딧은 대시보드의 Billing & subscription 페이지에서 구매합니다. 공개 API는
GET /v1/balance와GET /v1/usage를 읽을 수 있지만 충전 엔드포인트는 없습니다. - 모든 Format 실행에는 생성 지출 상한이 있으며, 영수증마다 상한과 그 상한에 대해 실행이 쓴 금액이 표시됩니다. 더 자세한 내용은 Sume 요금 체계와 Sume 에이전트 수수료란?에서 다룹니다.
결과물과 키는 어디에 속하나요?
API 키와 지출은 개인 또는 팀 워크스페이스로 해석됩니다. 팀이 소유한 Format에는 그 팀 워크스페이스에서 만든 키가 필요합니다. Sume 소유의 생성 결과물은 media.sume.com URL로 돌아오며, 문서는 이를 공개 아티팩트 계약이라고 부릅니다. 이 URL이 얼마나 유지되고 누가 열 수 있는지는 AI 생성 영상 URL은 만료되나요?에서 다룹니다.
출처
관련 글
에이전트 카테고리의 다른 글
- Agent Completions로 백엔드에서 Sume 영상 에이전트 실행
POST /v1/agent/completions는 Sume 에이전트 채팅과 같은 에이전트를 도구·미디어 생성과 함께 실행하고, 폴링하거나 웹훅으로 받는 비동기 실행 영수증을 돌려줍니다.
- 유료 API를 호출하는 AI 에이전트의 안전한 자동화
에이전트는 기본적으로 읽기 전용으로 두고 비밀 값은 로그에서 빼세요. 호스팅 MCP에서는 idempotency_key를 보내고, dry_run으로 미리 보고, max_spend_usd로 상한을 두세요.
- AI 영상 에이전트 스케줄 실행: cron, API 트리거, 영수증
Sume 스케줄은 cron 주기로 실행되고 실행 영수증을 돌려주는, 저장된 에이전트 자동화입니다. 대시보드에서 만들고, 실행 시작과 모니터링은 API로 합니다.
- Agent Completions·Format·Scheduled 요청 본문 차이
Sume Format·Scheduled 실행과 Agent Completions는 필드 이름만 같고, 지출 상한 기본값, null, on_active_run, attachments, 스코프 규칙은 다릅니다.
작성자 Sume