Sume 기초

이 문서는 영문 원고를 AI로 번역한 내용이라 표현이 어색할 수 있습니다.

Sume는 본질적으로 비디오 에이전트 플랫폼입니다. 사람은 채팅에서 작성하고 반복하며, 파트너는 저장해 둔 레시피를 HTTP로 호출합니다. 개별 생성 도구 (Image, Video, Avatar, TTS, timeline 등)도 HTTP API로 존재하지만, 파트너의 주 경로는 그 도구들을 조합하는 샌드박스 Agent / Format을 호출하는 것이지, 원본 모델 호출을 직접 이어 붙이는 것이 아닙니다.

그 조합 때문에 단일 Video 1.0 클립으로는 만들기 어려운 결과물을 낼 수 있습니다. 수 분짜리 호스트 영상, B-roll, 보이스오버, 타임라인 조립까지 이어진 게시 준비(post-ready) 비디오가 그 예입니다.

Job 접수·폴링·media.sume.com 메커니즘은 핵심 개념을 참고하세요.

한눈에

Agents

Agents는 사람이 샌드박스 Agent와 함께 작업하는 채팅 UI입니다. 브리프를 쓰고, 지출을 승인하고, 결과물을 확인하며, 몇 턴에 걸쳐 하우스 스타일을 다듬습니다.

Format도 여기서 작성합니다. 라이브러리에서 Format을 편집하거나, 채팅에서 Agent에게 레시피(SKILL.md와 참고 파일)를 저장해 달라고 요청하면 됩니다. 사람이 루프에 남아야 할 때는 대화형 채팅이 맞는 표면입니다.

문서: Agents 개요 · 안전한 자동화

Formats / Format API

Format은 저장해 둔 작성 레시피입니다. 파트너는 handle과 slug로 호출하고, Sume는 새 샌드박스를 띄운 뒤 레시피를 로드하고, 생성 도구를 쓰는 Agent를 실행한 다음 아티팩트와 (선택적) 구조화 JSON을 돌려줍니다.

대부분의 파트너가 연동해야 하는 표면입니다. HTTP 한 번이 그렇지 않으면 자체 글루 코드에 들어가게 될 판단과 오케스트레이션을 담당합니다.

문서: Format API 개요 · Format 호출하기 · 대량 실행 · Cookbook: Format 임베드

Models

Models는 원자적 생성 엔드포인트입니다. 아바타 생성, 토킹 클립 렌더, 이미지·짧은 비디오 클립 생성, 캡션 추가 등이 여기에 해당합니다. 실제 제품 표면이며, 모델 호출 한 번만 필요할 때 유용합니다.

Formats에 비하면 지원 역할입니다. Format이 어떤 도구를 어떤 순서로 호출하고 결과를 어떻게 조립할지 정합니다. 클립이나 이미지 하나만 필요하면 모델을 호출하고, 패키지된 워크플로가 필요하면 Format을 호출하세요.

문서: Models 개요 · Video 1.0 · 아바타 비디오

Agent Completions / Scheduled

모든 Agent 작업이 Format으로 저장할 가치는 없습니다.

SurfaceWhen to use
Agent Completions백엔드 일회성 작업; 레시피로 저장할 가치 없음
Scheduled같은 저장 작업을 주기적으로 (Actions)

둘 다 Agent를 실행합니다. Completions는 임시, Scheduled는 반복입니다. 레시피는 고정이고 입력만 바뀔 때는 Format이 맞는 경로입니다.

SDK

TypeScript SDK는 Node / Bun / Deno / Workers를 위한 같은 Developer API 위의 얇은 클라이언트입니다. subscribeFormatRun이 있어 폴링을 직접 구현하지 않아도 됩니다. SDK가 하는 일은 모두 순수 HTTP로도 가능합니다.

클라이언트가 둘 더 있고 여전히 동작하지만, 오늘의 주 경로는 아닙니다. 로컬 셸과 스크립트를 위한 CLI, 원격 MCP를 지원하는 클라이언트를 위한 호스팅 MCP입니다. 환경상 필요할 때 쓰시고, 기본 연동 경로로 잡지는 마세요.

Dashboard

대시보드는 API 키가 해석하는 같은 워크스페이스의 사람용 운영 표면입니다.

문서: API 키 · Jobs · Usage · 결제

Developer API + media

DomainRole
api.sume.com공개 Developer API (/v1)와 OpenAPI (/reference/json)
media.sume.com1st-party 생성 미디어 아티팩트

키로 인증하며 API는 워크스페이스 범위입니다. Sume 소유의 생성 결과물은 media.sume.com URL로 돌아옵니다. 이것이 공개 아티팩트 계약입니다.

문서: Public API · API 레퍼런스 · 인증 · 미디어 입력

Workspaces

API 키와 지출은 워크스페이스로 해석됩니다. 키에 그 컨텍스트가 들어 있으므로 요청 본문에 workspace_id를 넣지 마세요. 팀 소유 Format은 vanity·opaque 경로 모두로 호출할 수 있지만, 그 팀 워크스페이스에서 만든 키가 필요합니다. 개인 키는 403 workspace_key_required로 실패합니다 — 팀 Format에는 팀 키가 필요합니다.

다음에 볼 것

  • 빠른 시작 — Agents 탭에서든 API로든, 첫 실행
  • Format API — Format이 왜 존재하는지, run이 끝까지 어떻게 돌아가는지
  • 핵심 개념 — Job, 접수, 아티팩트, 사용량