CLI 개요
sume.com 개발자 플랫폼을 위한 현재 Sume CLI 표면을 살펴보세요.
이 문서는 영문 원고를 AI로 번역한 내용이라 표현이 어색할 수 있습니다.
Sume CLI는 현재 api.sume.com/v1 Developer API를 감싸는 agent-first 래퍼입니다.
이전 소비자 제품 CLI 표면과는 의도적으로 분리되어 있습니다.
현재 상태
출시된 CLI(sumelabs/cli)는 계정 확인, 카탈로그 탐색, Job, 입력 에셋,
Avatar 1.0, Avatar Video 1.0, 번들 agent skills, 스키마 탐색, 로컬 진단을
지원합니다.
생성 기능은 Avatar 중심입니다. 오늘 기준으로 Image 1.0, Video 1.0, Music 1.0을 위한 일급 CLI 서브커맨드는 없습니다. 이 계열은 Developer API를 직접 호출하세요(Image, Video, Music 참고).
로컬 sume mcp는 현재 CLI 릴리스에서 출시되지 않았습니다(coming_soon).
Cursor/Claude에서 원격 MCP를 쓰려면 https://mcp.sume.com/mcp의
호스팅 MCP 커넥터를 사용하세요.
호스팅 인스톨러로 현재 네이티브 바이너리를 설치합니다.
Windows PowerShell은 다음과 같습니다.
인스톨러는 최신 sumelabs/cli GitHub Release를 확인해 플랫폼에 맞는 바이너리를
내려받고, checksums.txt로 검증한 뒤 ~/.sume-com/bin 아래에 sume를
설치합니다.
그다음 로그인하세요. sume login은 호스팅 MCP와 같은 Sume 로그인을 씁니다.
브라우저가 열리면 Allow를 누르고, 리디렉션은 127.0.0.1의 CLI로 돌아옵니다.
SSH나 브라우저가 없는 머신에서는 코드로 로그인하세요.
로그인은 유지됩니다. CLI가 1시간짜리 액세스 토큰을 두고 알아서 갱신하며,
sume logout으로 취소합니다. 스크립트는 지금처럼 API 키를 써도
됩니다(SUME_API_KEY, 또는 sume login --api-key <key>). API를 직접 호출하는
스크립트에는 sume auth token이 현재 액세스 토큰을 출력합니다.
로그인과 API 키를 참고하세요.
API 베이스
자주 쓰는 명령어
기계가 읽을 안정적인 출력이 필요하면 --json을 쓰고, 민감한 URL이나 계정
메타데이터가 포함될 수 있는 출력을 자동화가 읽는다면 --agent를 쓰세요.
아바타 비디오 스크립트는 4~12초 범위로 추정되어야 합니다.