Sume CLI 명령어 레퍼런스: 계정, Job, 에셋, skills
Sume CLI에는 생성 외에도 로그인과 계정, health·doctor 점검, 스키마 탐색, Job, 에셋, 배치 헬퍼, skills, 별칭 명령어가 있습니다.
Sume CLI(sume)는 계정 확인, 카탈로그 탐색, Job, 입력 에셋, Avatar 1.0과 Avatar Video 1.0, 번들 agent skills, 스키마 탐색, 로컬 진단을 지원합니다. 생성 제출 경로는 Avatar 명령어뿐이고, 나머지는 계정, 조회, Job 복구, 에셋, 설정을 다루며, sume tools schema <name> --json은 런타임에 정확한 스키마를 출력합니다.
이 목록은 CLI 명령어 레퍼런스와 Job과 미디어 입력 페이지를 바탕으로 하며, 2026-09-26에 확인했습니다. 문서에 따르면 CLI는 여전히 동작하지만 현재 주 경로는 아닙니다. 터미널에서 하는 Avatar 생성은 CLI 튜토리얼에서 다룹니다.
Sume CLI에는 어떤 명령어가 있나요?
아래 명령어는 모두 sume로 시작합니다. 기계가 읽을 수 있는 안정적인 출력이 필요하면 --json을 붙이고, CLI가 지원하는 곳에서 URL 형태의 필드와 민감한 계정·워크스페이스 필드를 가리려면 --agent를 붙이세요.
| 그룹 | 명령어 | 문서 설명 |
|---|---|---|
| 인증 | login, login --no-browser, logout, auth status, auth setup --api-key | --no-browser는 원격·헤드리스 터미널용으로 승인 URL을 출력 |
| 계정 | me, account get, balance, usage get --limit 20 | me와 account get 모두 설정된 키의 계정 컨텍스트를 읽음 |
| 카탈로그와 상태 확인 | catalog list, health, health service, health v1 | 읽기 명령어 |
| 로컬 진단 | doctor --agent --json, version, update --check | doctor는 API를 호출하지 않고 로컬 준비 상태를 확인. update --check는 로컬 파일을 바꾸지 않음 |
| 스키마 | tools list --json, tools schema <name> --json | 런타임에 정확한 스키마 확인 |
| Job | jobs list, get, status, events, result, watch, download, cancel | watch는 종료 상태나 타임아웃까지 폴링. download --output-dir로 완료된 미디어 저장. cancel에는 --confirm-submit 필요 |
| 에셋 | assets list, get, create --source-url, download-url, download | 쓰기 경로에는 게이트가 있음. 아래 상태 설명 참고 |
| 아바타 | avatars list, get, create, batch; avatar-videos list, get, create, batch | 유일한 생성 제출 명령어. create에는 --confirm-paid 필요 |
| Skills | skills list, install <name>, update, remove <name>, export <name> | .agents/skills 또는 .claude/skills에 설치 |
명령어의 정확한 플래그는 어떻게 확인하나요?
CLI에 물어보세요. sume tools list --json과 sume tools schema <name> --json은 런타임에 정확한 스키마를 확인합니다. 문서에서는 jobs.result, assets.create, avatars.create, avatar-videos.create를 스키마 이름으로 씁니다. 문서는 쓰기나 유료 단계 전에 읽기 전용 스키마 명령어로 페이로드를 검증하라고 권합니다.
배치 헬퍼인 sume avatars batch와 sume avatar-videos batch는 로컬 상태 파일을 대상으로 plan, create, watch, result 단계를 실행합니다. sume avatars batch --help로 살펴보세요. skills의 경우 sume skills export sume로 커스텀 설치 전에 패키징된 skill의 소스 파일을 검토할 수 있습니다.
어떤 명령어에 확인 플래그가 필요한가요?
쓰기 명령어에는 명시적인 확인이 필요합니다. sume jobs cancel <job_id>나 에셋 등록처럼 유료가 아닌 쓰기에는 --confirm-submit이, 크레딧을 예약하거나 쓸 수 있는 sume avatars create와 sume avatar-videos create에는 --confirm-paid가 필요합니다. 이 게이트를 둘러싼 에이전트 안전 루프는 CLI 튜토리얼에서 볼 수 있습니다.
에셋 명령어는 현재 어떤 상태인가요?
에셋 명령어는 공개 URL만으로는 부족하고 에셋 ID가 필요한 워크플로를 위해 자사 입력 에셋을 나열하고, 등록하고, 내려받습니다. CLI는 Developer API를 감싸는데, 그 /v1/assets 라우트는 구현돼 있지만 공개 OpenAPI 문서에서는 숨겨져 있습니다. API 레퍼런스는 이 라우트가 OpenAPI 문서에 다시 나타날 때까지 문서화된 공개 계약으로 취급하지 말라고 안내합니다. 두 페이지의 조언은 같습니다. 생성 요청에는 공개 HTTPS 미디어 URL을 쓰는 편이 좋습니다.
어떤 명령어가 별칭이고, 어떤 명령어가 없나요?
sume models list는 sume catalog list의 지원 중단(deprecated) 별칭이고, sume me는 sume account get과 같은 계정 컨텍스트를 읽습니다.
sume image, sume video, sume music 서브커맨드는 없습니다. CLI 문서는 이 작업을 HTTP로 Image 1.0, Video 1.0, Music 1.0에 보내도록 안내합니다. Image 1.0과 Video 1.0은 곧 은퇴하므로, 새 연동은 마이그레이션 가이드의 설명처럼 sume/auto로 POST /v1/images나 POST /v1/videos를 호출합니다. Music 1.0은 점진적으로 은퇴하며 POST /v1/music-router/generate로 대체됩니다. API로 만든 Job도 sume jobs status, result, download로 여전히 복구할 수 있습니다. 스케줄에는 CLI 명령어가 아예 없습니다. 이 명령어를 무인으로 실행하는 방법은 CI에서 Sume CLI 실행하기를 참고하세요.
출처
관련 글
작성자 Sume