명령어

에이전트나 스크립트가 출력을 파싱한다면 모든 명령에 --json을 사용하세요.

인증과 설정

sume login
sume login --no-browser
sume auth status
sume logout
sume setup --api-key "$SUME_API_KEY"
sume setup --base-url "https://www.sume.so/api/v1"

sume login은 Sume 승인 페이지를 열고 범위가 지정된 로컬 API 키를 저장합니다. CI에서는 SUME_API_KEY를 선호합니다.

계정과 크레딧

sume me
sume me --json
sume credits
sume credits --json

생성 전에 CLI가 기대한 계정과 워크스페이스를 바라보는지 확인합니다.

작업

sume jobs list --limit 5
sume jobs list --status completed --limit 5
sume jobs get <job_id> --json
sume jobs result <job_id> --json
sume jobs result <job_id> --download ./outputs/

옵션	설명
--limit <n>	페이지 크기입니다.
--cursor <cursor>	페이지네이션을 이어갑니다.
--type <type>	작업 유형으로 필터링합니다.
--status <status>	작업 상태로 필터링합니다.
--download [path]	안전한 공개 미디어 URL을 파일로 다운로드합니다.

Assets

sume assets list --limit 5 --json
sume assets search "mask application" --source-type generated --limit 5 --json
sume assets get <asset_id> --json
sume assets get <asset_id> --download ./assets/

옵션	설명
--query <query>	assets list의 검색어입니다.
--source-type <type>	업로드/생성 같은 소스 유형으로 필터링합니다.
--brand <brand>	브랜드 언급으로 필터링합니다.
--product <product>	제품 언급으로 필터링합니다.
--tag <tag>	재사용 태그로 필터링합니다.
--min-duration / --max-duration	장면 길이로 필터링합니다.

생성

sume images generate --prompt "clean product photo" --wait --json
sume videos generate --prompt "short vertical product demo" --duration 4 --json
sume reference-analysis create --url "https://www.tiktok.com/@brand/video/123" --json

생성 명령은 크레딧을 사용할 수 있으므로 에이전트 실행 전 사용자 확인이 필요합니다.