---
title: 빠른 시작
description: Agents 탭에서 시작하거나, 저장한 Format을 Developer API로 호출하세요.
---

시작 경로는 둘입니다. **Agents** 탭에서 에이전트와 함께 작업하거나, 저장한
Format을 **API**로 호출하세요. 대부분의 팀은 둘 다 씁니다. Agents에서 만들고,
그 레시피를 백엔드에서 호출합니다.

제품 맵이 처음이라면 먼저 [Sume 기초](/the-basics)를 읽으세요. Agents, Formats,
Models, 그리고 파트너에게 어떤 표면이 주 경로인지 정리되어 있습니다.

자세한 가이드: [Format API](/formats) · [Format 호출하기](/formats/call) ·
[Agents 개요](/agents) · [Models 개요](/models).

<!-- quick-start-options:start -->

Agents

## 옵션 1: 브리프 하나로 시작하기

[sume.com/agents](https://www.sume.com/agents)의 입력창에 아래를 붙여 넣으세요.
스레드에 모든 아티팩트와 승인 기록이 남습니다.

```text
내 제품을 소개하는 15초 세로형 프로모션 영상을 만들어 줘. 프리젠터 아바타를
쓰고 자막을 넣어 줘. 최종 렌더에 크레딧을 쓰기 전에 먼저 초안을 보여 줘. 내가
승인하면 이 스레드의 레시피를 product-promo라는 Format으로 저장해서 내
백엔드에서 호출할 수 있게 해 줘.
```

## 옵션 2: 스레드에서 이어가기

사람이 루프에 남아야 할 때 Agents 탭을 쓰세요. 브리프를 쓰고, 확인하고,
반복한 뒤, 결과를 재사용 가능한 레시피로 저장합니다.

1. Agents 탭 열기

로그인하고 스레드를 시작하세요. 설치할 것은 없습니다.

```text
https://www.sume.com/agents
```

2. 에이전트에게 브리프 주기

도구 호출이 아니라 결과물을 설명하세요. 모델은 에이전트가 고르고, 지출 전에
먼저 물어봅니다.

```text
프리젠터 아바타와 자막을 넣은 15초 세로형 제품 프로모션 영상을 만들어 줘.
최종 렌더 전에 초안을 먼저 보여 줘.
```

3. 레시피를 Format으로 저장하기

Format은 같은 스레드의 레시피를 handle과 slug로 부를 수 있게 만든 것입니다.
백엔드가 나중에 호출하는 대상이 바로 이것입니다.

```text
이걸 product-promo라는 Format으로 저장해 줘.
```

다음: [Agents 개요](/agents).

API

## 옵션 1: Agent로 시작하기

서버 연동 코드를 편집하거나 실행할 수 있는 Agent에 아래를 붙여 넣으세요.

```text
내 서버 환경에서 Sume Format을 호출해 줘. 인증에는 SUME_API_KEY를 쓰고,
POST https://api.sume.com/v1/formats/{handle}/{slug}/runs 에
{"instruction": "..."} JSON 본문과 Idempotency-Key 헤더를 함께 보내 줘.
호출은 202와 run 접수증을 돌려주니, run이 queued/running을 벗어날 때까지
status_url을 폴링한 뒤 result_url을 읽어서 아티팩트와 structured output을
반환해 줘. SUME_API_KEY가 없으면 https://www.sume.com/dashboard/api-keys 에서
formats:read와 formats:write 스코프로 키를 만들라고 나에게 알려 줘.
```

## 옵션 2: 직접 사용하기

백엔드가 저장된 Format을 직접 실행해야 할 때 API를 쓰세요. 호출 한 번이 직접
작성했을 오케스트레이션을 대신합니다.

1. **[API Keys 대시보드](https://www.sume.com/dashboard/api-keys)**에서
   `formats:read`와 `formats:write` 스코프로 API 키를 만든 뒤 내보내기:

```bash
export SUME_API_KEY="sume_live_..."
```

2. Format run 시작하기. 상세 페이지에 표시되는 handle과 slug로 호출합니다.
   접수된 run은 `202`와 접수증을 돌려줍니다:

<!-- api-call-example:format-vanity-run -->

3. 결과 읽기. run이 `queued` / `running`을 벗어날 때까지 `status_url`을 폴링한
   뒤 `result_url`을 읽으세요:

```bash
curl -sS https://api.sume.com/v1/format-runs/run_.../status \
  -H "Authorization: Bearer $SUME_API_KEY"
```

프로덕션에서는 폴링보다 [웹훅](/sdk/webhooks)을 권장합니다. 또는
[TypeScript SDK](/sdk/runs)에 대기를 맡기세요.

다음: [Format 호출하기](/formats/call).

<!-- quick-start-options:end -->

패키지된 워크플로가 아니라 모델 호출 하나만 필요하다면
[아바타 만들기](/models/avatar), [Image 1.0](/models/image),
[API 레시피](/api/cookbook)로 바로 가세요.