---
title: 핵심 개념
description: Sume 개발자 플랫폼을 이루는 주요 객체와 수명주기를 살펴보세요.
---

이 페이지는 **Job과 접수** 맵입니다 — 카탈로그, Job, artifact, 사용량.
Agents, Formats, Models, 클라이언트 제품 맵은 [Sume 기초](/the-basics)를 보세요.

Sume 생성 워크플로는 작은 공개 객체 집합으로 구성됩니다. 카탈로그 항목, 미디어 입력, Job, artifact, 사용량 항목, 대시보드 리소스입니다.

## 플랫폼 도메인

| Domain / URL | Role |
|---|---|
| `www.sume.com/dashboard` | 대시보드 홈과 운영자 표면입니다. |
| `www.sume.com/dashboard/api-keys` | API 키 관리입니다. |
| `www.sume.com/dashboard/jobs` | Job 조회입니다. |
| `www.sume.com/dashboard/usage` | 사용량과 잔액 요약입니다. |
| `www.sume.com/dashboard/subscription` | 결제·구독 / 크레딧 충전입니다. |
| `www.sume.com/playground` | Avatar playground입니다. |
| `api.sume.com` | 공개 Developer API(`/v1`)와 OpenAPI(`/reference/json`)입니다. |
| `media.sume.com` | 1st-party 생성 미디어 artifact입니다. |

## Catalog

프로그램 방식 탐색의 출발점은 `GET /v1/catalog`입니다. 사용 가능한 능력, 모델 id, 엔드포인트 경로, 런타임 준비 상태, 가격 메타데이터를 나열합니다.

## Jobs

생성 요청은 내구성 있는 Job을 만듭니다. Job은 요청 메타데이터, 상태, 공개 provider 모델, 결과, 공개 오류, 이벤트, 웹훅 전달 상태를 추적합니다.

지원 상태:

```text
queued -> processing -> completed
queued -> processing -> failed
queued -> canceled
```

## 생성 수명주기

```text
client submit
  -> Sume validates API key and request
  -> optional usage reservation
  -> provider-backed execution
  -> artifact mirroring to media.sume.com
  -> usage capture or refund
  -> terminal webhook delivery when configured
  -> result available from /v1/jobs/:id/result
```

클라이언트가 끊기거나 로컬에서 타임아웃돼도 `job_id`를 유지하고 Jobs API로 복구하세요. 유료 작업을 중복 제출하지 마세요.

## Artifacts

완료된 Job은 `https://media.sume.com` 아래 공개 artifact를 포함할 수 있습니다. Sume 소유의 artifact URL이 공개 계약입니다. 원본 provider URL은 아닙니다.

## 미디어 입력

생성 요청은 `input.image_url`, `product_image`, `scene.image_url`, `video_url`(페이스 스왑/캡션)처럼 스키마에 정의된 필드에 공개 HTTPS 미디어 URL을 받습니다. 일반적인 연동에는 별도 asset 업로드 단계가 필요 없습니다. 생성 출력은 `media.sume.com`의 Sume 호스팅 artifact로 돌아옵니다. [미디어 입력](/workflows/asset-library)을 참고하세요.

## Usage

provider 기반 생성은 예상 USD 사용량을 예약하고, 성공 시 실제 비용을 확정하며, 확정 전 실패·취소 시 환불할 수 있습니다. 현재 잔액과 원장 항목은 `/v1/balance`와 `/v1/usage`로 확인하세요.

## 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)