명령어 레퍼런스
이 문서는 영문 원고를 AI로 번역한 내용이라 표현이 어색할 수 있습니다.
이 페이지는 sumelabs/cli의 현재 개발자 플랫폼 CLI 표면을 정리한 문서입니다.
지원하지 않는 예전 소비자 제품 명령어는 의도적으로 제외했습니다. Image/Video/
Music 생성기가 CLI 서브커맨드로 있다고 가정하지 마세요. 아직 없습니다.
정확한 스키마는 런타임에 확인할 수 있습니다.
인증과 계정
sume me와 sume account get은 모두 설정된 키의 계정 컨텍스트를 읽습니다.
읽기 명령어
sume models list는 sume catalog list의 DEPRECATED 별칭으로 남아 있습니다.
Job 헬퍼
에셋
에셋 등록과 업로드 경로에는 쓰기 게이트가 걸려 있습니다. 자사 에셋 ID가 꼭 필요하지 않다면 생성 페이로드에 공개 HTTPS URL을 쓰는 편이 좋습니다. Job과 미디어에서 자세히 살펴보세요.
쓰기와 유료 생성(Avatar)
쓰기 명령어에는 명시적인 확인이 필요합니다. 오늘 CLI에서 일급 생성 제출 경로는 유료 Avatar 생성기뿐입니다.
프로바이더 실행이 크레딧을 소모할 수 있을 때는 --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 |
| Video 1.0 | Video |
| Music 1.0 | Music |
API로 이 Job들을 제출한 뒤에도 sume jobs status / sume jobs result /
sume jobs download로 결과를 가져올 수 있습니다.
MCP (CLI vs 호스팅)
로컬 sume mcp는 현재 릴리스에서 coming_soon / launched: false를
보고합니다. sume mcp install은 아직 제공하지 않습니다.
Cursor, Claude를 비롯한 원격 MCP 클라이언트에서는
https://mcp.sume.com/mcp의 호스팅 MCP 엔드포인트를 사용하세요. 로컬
CLI 명령어와는 별개의 표면입니다.
기계가 읽는 출력
--agent는 CLI가 agent-safe 출력을 지원하는 곳에서 URL 형태의 값과 민감한
계정·워크스페이스 필드를 가립니다.
Skills
Agent skills에서 자세히 살펴보세요.