---
title: 명령어 레퍼런스
description: 현재 Sume CLI 명령어 그룹과 안전 게이트를 살펴보세요.
---

이 페이지는 `sumelabs/cli`의 현재 개발자 플랫폼 CLI 표면을 정리한 문서입니다.
지원하지 않는 예전 소비자 제품 명령어는 의도적으로 제외했습니다. Image/Video/
Music 생성기가 CLI 서브커맨드로 있다고 가정하지 마세요. 아직 없습니다.

정확한 스키마는 런타임에 확인할 수 있습니다.

```bash
sume tools list --json
sume tools schema <name> --json
```

## 인증과 계정

```bash
sume login
sume login --no-browser
sume logout
sume auth status
sume auth setup --api-key "$SUME_API_KEY"
sume me
sume account get
sume balance
sume usage get --limit 20
```

`sume me`와 `sume account get`은 모두 설정된 키의 계정 컨텍스트를 읽습니다.

## 읽기 명령어

```bash
sume catalog list
sume health
sume health service
sume health v1
sume doctor --agent --json
sume jobs list
sume jobs get <job_id>
sume jobs status <job_id>
sume jobs events <job_id>
sume jobs result <job_id>
sume assets list
sume assets get <asset_id>
sume avatars list
sume avatars get <avatar_id>
sume avatar-videos list
sume avatar-videos get <avatar_video_id>
sume tools list --json
sume tools schema jobs.result --json
sume skills list
sume version
sume update --check
```

`sume models list`는 `sume catalog list`의 DEPRECATED 별칭으로 남아 있습니다.

## Job 헬퍼

```bash
sume jobs watch <job_id>
sume jobs download <job_id> --output-dir ./out
sume jobs cancel <job_id> --confirm-submit
```

## 에셋

```bash
sume assets create --source-url https://example.com/reference.png --confirm-submit
sume assets upload-url --content-type image/png --size-bytes 12345 --confirm-submit
sume assets complete <asset_id> --confirm-submit
sume assets download-url <asset_id>
sume assets download <asset_id> --output-dir ./assets
```

에셋 등록과 업로드 경로에는 쓰기 게이트가 걸려 있습니다. 자사 에셋 ID가 꼭
필요하지 않다면 생성 페이로드에 공개 HTTPS URL을 쓰는 편이 좋습니다.
[Job과 미디어](/cli/jobs-assets)에서 자세히 살펴보세요.

## 쓰기와 유료 생성(Avatar)

쓰기 명령어에는 명시적인 확인이 필요합니다. 오늘 CLI에서 일급 생성 제출 경로는
유료 Avatar 생성기뿐입니다.

```bash
sume avatars create --confirm-paid --avatar-handle studio_presenter --type prompt --prompt "Friendly presenter"
sume avatars create --confirm-paid --avatar-handle reference_presenter --type photo --image-url https://example.com/reference.png
sume avatar-videos create --confirm-paid --avatar-handle sume_clawra --script "Say hello" --quality plus
sume avatar-videos create --confirm-paid --avatar-handle sume_clawra --product-image https://example.com/product.png --script "Introduce this product naturally" --quality plus
```

프로바이더 실행이 크레딧을 소모할 수 있을 때는 `--confirm-paid`를 사용하세요.
Job 취소나 에셋 등록처럼 유료가 아닌 쓰기에는 `--confirm-submit`을 사용합니다.
아바타 비디오 스크립트는 제출 전에 4~60초 범위로 추정되어야 합니다.
Avatar Video의 `quality`는 생략하면 **`plus`**가 기본값입니다.

`sume avatars batch`와 `sume avatar-videos batch` 아래에 배치 헬퍼도 있습니다
(로컬 상태 파일을 대상으로 plan / create / watch / result를 수행합니다).
`sume avatars batch --help`로 살펴보세요.

## CLI 생성기로 제공하지 않는 것

CLI는 `sume image`, `sume video`, `sume music` 같은 서브커맨드를 **제공하지
않습니다**. 대신 HTTP API를 사용하세요.

| 계열 | 가이드 |
|---|---|
| Image 1.0 | [Image](/models/image) |
| Video 1.0 | [Video](/models/video) |
| Music 1.0 | [Music](/models/music) |

API로 이 Job들을 제출한 뒤에도 `sume jobs status` / `sume jobs result` /
`sume jobs download`로 결과를 가져올 수 있습니다.

## MCP (CLI vs 호스팅)

```bash
sume mcp doctor --json
```

로컬 `sume mcp`는 현재 릴리스에서 `coming_soon` / `launched: false`를
보고합니다. `sume mcp install`은 아직 제공하지 않습니다.

Cursor, Claude를 비롯한 원격 MCP 클라이언트에서는
`https://mcp.sume.com/mcp`의 [호스팅 MCP](/mcp) 엔드포인트를 사용하세요. 로컬
CLI 명령어와는 별개의 표면입니다.

## 기계가 읽는 출력

```bash
sume catalog list --json
sume jobs result <job_id> --agent --json
```

`--agent`는 CLI가 agent-safe 출력을 지원하는 곳에서 URL 형태의 값과 민감한
계정·워크스페이스 필드를 가립니다.

## Skills

```bash
sume skills list
sume skills install <name>
sume skills update
sume skills remove <name>
sume skills export <name>
```

[Agent skills](/cli/agent-skills)에서 자세히 살펴보세요.