---
title: Sume 기초
description: Sume 표면의 제품 맵 — Agents, Formats, Models, SDK, Dashboard, Developer API.
---

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

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

Job 접수·폴링·`media.sume.com` 메커니즘은 [핵심 개념](/workflows/core-workflow)을
참고하세요.

## 한눈에

- **[Agents](#agents)** — [sume.com/agents](https://www.sume.com/agents)의 사람 개입 작성 UI
- **[Formats / Format API](#formats--format-api)** — 파트너가 주로 호출하는 표면
- **[Models](#models)** — 원자적 생성 API (지원 빌딩 블록)
- **[Agent Completions / Scheduled](#agent-completions--scheduled)** — 일회성·주기적 Agent 실행
- **[SDK](#sdk)** — 같은 Developer API 위의 TypeScript 클라이언트
- **[Dashboard](#dashboard)** — 키, Job, 사용량, 결제
- **[Developer API + media](#developer-api--media)** — `api.sume.com`과 `media.sume.com`
- **[Workspaces](#workspaces)** — 키와 지출이 해석되는 단위

## Agents

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

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

문서: [Agents 개요](/agents) · [안전한 자동화](/agents/safe-automation)

## Formats / Format API

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

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

```text
Format run = fresh sandbox + recipe (SKILL) + instruction/input + tools
           → artifacts + optional structured output
```

문서: [Format API 개요](/formats) · [Format 호출하기](/formats/call) ·
[대량 실행](/formats/bulk-runs) ·
[Cookbook: Format 임베드](/cookbooks/embed-a-format)

## Models

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

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

문서: [Models 개요](/models) · [Video 1.0](/models/video) ·
[아바타 비디오](/models/avatar-videos)

## Agent Completions / Scheduled

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

| Surface | When to use |
|---|---|
| [Agent Completions](/agents/completions) | 백엔드 일회성 작업; 레시피로 저장할 가치 없음 |
| [Scheduled](/agents/actions) | 같은 저장 작업을 주기적으로 (Actions) |

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

## SDK

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

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

## Dashboard

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

- [API keys](https://www.sume.com/dashboard/api-keys)
- [Jobs](https://www.sume.com/dashboard/jobs)
- [Usage](https://www.sume.com/dashboard/usage)
- [Billing & subscription](https://www.sume.com/dashboard/subscription)
- [Playground](https://www.sume.com/playground)

문서: [API 키](/dashboard/api-keys) · [Jobs](/dashboard/jobs) ·
[Usage](/dashboard/usage) · [결제](/dashboard/credits)

## Developer API + media

| Domain | Role |
|---|---|
| `api.sume.com` | 공개 Developer API (`/v1`)와 OpenAPI (`/reference/json`) |
| `media.sume.com` | 1st-party 생성 미디어 아티팩트 |

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

문서: [Public API](/public-api) · [API 레퍼런스](/api/reference) ·
[인증](/authentication) · [미디어 입력](/workflows/asset-library)

## Workspaces

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

## 다음에 볼 것

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