|문서

개요

Sume CLI는 Sume Public API 위에 얇게 얹은 래퍼입니다. 터미널에서 사람이 읽기 좋게 사용할 수 있고, 에이전트는 일반 셸 명령과 --json 출력으로 사용할 수 있습니다.

기본 API 주소:

https://www.sume.so/api/v1

CLI를 쓰는 이유

  • 사람용 출력이 간결합니다.
  • --json은 자동화를 위한 구조화된 출력을 반환합니다.
  • 명령어가 Public API 엔드포인트와 매핑됩니다.
  • Sume 데이터베이스, 큐, provider API, 배포 서비스, 내부 라우트에 직접 연결하지 않습니다.
  • Sume이 반환한 안전한 공개 미디어 URL을 다운로드할 수 있습니다.

설치

macOS와 Linux:

curl https://cli.sume.so/install -fsS | bash

Windows PowerShell:

irm https://cli.sume.so/install.ps1 | iex

그 다음 인증합니다.

sume login
sume me
sume credits

읽기 명령어

sume auth status
sume me --json
sume credits --json
sume jobs list --limit 5 --json
sume assets search "product demo hook" --limit 5 --json
sume assets get <asset_id> --json

생성 명령어

생성 명령은 크레딧을 사용할 수 있습니다. 에이전트가 실행할 때는 사용자 의도를 확인하세요.

sume images generate \
  --prompt "Clean product photo on a white bathroom counter." \
  --wait \
  --json

sume videos generate \
  --prompt "Four-second vertical product demo." \
  --duration 4 \
  --resolution 480p \
  --json

에이전트 모드

다른 프로그램이 출력을 파싱할 때는 항상 --json을 사용하세요.

sume tools list --json
sume tools schema assets.search --json
sume assets search "woman looking at camera hook" --source-type generated --limit 5 --json

에이전트는 전체 URL, request id, 사용자 이메일, workspace id, API key id, 큰 raw payload를 요약하거나 제거해야 합니다.