2026-09-26개발자

Sume CLI가 안 될 때: 로그인·API 베이스·Job·미디어 해결법

Sume CLI가 안 될 때는 읽기 전용 점검 네 가지를 먼저 실행한 뒤, 키 누락, 잘못된 API 베이스, 끝나지 않은 Job, 거부된 미디어 URL 중 해당하는 원인을 고치세요.

읽는 시간 5분Sume

Sume CLI가 동작하지 않으면 먼저 읽기 전용 점검 네 가지를 실행하세요. sume version, sume auth status, sume doctor --agent --json, sume account get --json입니다. 그다음 증상을 짚어 보세요. API 키 미설정, 잘못된 API 베이스, 아직 끝나지 않은 Job, 존재하지 않는 생성 명령어, Sume가 가져올 수 없는 미디어 URL 중 하나입니다.

해결 방법은 CLI 문제 해결과 보안 페이지를 바탕으로 하며, 2026-09-26에 확인했습니다. CLI는 여전히 동작하지만, 문서에 따르면 현재 주 경로는 아닙니다. 설치와 첫 로그인은 CLI 튜토리얼에서 다룹니다.

어떤 CLI 문제를 겪고 있나요?

sume doctor --agent --json은 API를 호출하지 않고 로컬 준비 상태를 확인하므로 가장 먼저 실행해도 안전합니다. 아래 표는 문서가 다루는 각 증상과 그 해결 방법을 짝지어 보여 줍니다.

CLI 문제 해결 기준, 2026-09-26 확인.
증상	해결
API 키 없음	`sume login`, 원격·헤드리스 터미널에서는 `sume login --no-browser`. CI에서는 `sume auth setup --api-key` 또는 환경 변수
잘못된 API 베이스	`sume doctor --agent --json`으로 로컬 설정 확인. 프로덕션 베이스는 `https://api.sume.com/v1`
Job은 생성됐지만 아직 결과 없음	`sume jobs status`로 폴링하고, 완료된 뒤에만 `sume jobs result`로 결과 가져오기
Image, Video, Music 명령어 없음	해당 명령어는 없음. Developer API로 제출한 뒤 `sume jobs`로 복구
미디어 입력 거부	쿠키, 인증 헤더, 짧은 수명의 서명 없이 열리는 공개 HTTPS 이미지 URL 사용

키가 없거나 API 베이스가 잘못됐으면 어떻게 고치나요?

키가 없으면 sume login을 실행하고 sume auth status로 확인하세요. 그래도 키가 없는 것 같거나 호출이 엉뚱한 곳으로 간다면, CLI가 설정을 어디서 읽는지 확인하세요.

인증 정보는 환경 변수에서 올 수도 있고, 기본값이 ~/.sume-com/config.json인 로컬 설정에서 올 수도 있습니다. 문서의 이슈 보고 체크리스트가 실패한 명령어가 둘 중 무엇을 썼는지 묻기 때문에 두 곳을 모두 확인하세요.
SUME_CONFIG_DIR 변수는 로컬 설정 디렉터리를 재정의하므로, 이미 마친 로그인을 CLI가 인식하지 못하면 이 변수를 확인하세요.
SUME_API_BASE_URL의 기본값은 프로덕션 베이스인 https://api.sume.com/v1입니다. 호출이 다른 곳으로 간다면 이 변수와 doctor 출력을 확인하세요.
CI에서는 API Keys 대시보드에서 발급한 키를 sume auth setup --api-key "$SUME_API_KEY"나 SUME_API_KEY 변수로 설정하세요. 무인 설정은 CI 가이드에서 다룹니다.

Job 결과가 왜 아직 없나요?

Job은 비동기입니다. 상태를 폴링하고, 결과는 Job이 완료된 뒤에만 가져오세요. 로컬 대기가 타임아웃됐다면 다른 유료 Job을 제출하기 전에 그 Job부터 확인하세요. sume jobs watch는 Job이 종료 상태가 되거나 타임아웃될 때까지 폴링하며, 복구 명령어가 유료 생성의 재제출을 대신합니다.

sume jobs status <job_id> --agent --json
sume jobs result <job_id> --agent --json
sume jobs watch <job_id>

sume video 명령어는 왜 없나요?

출시된 CLI에는 sume image, sume video, sume music 서브커맨드가 없습니다. CLI 문서는 이 작업을 Developer API로 보내며 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로 대체됩니다. 어느 쪽이든 sume jobs status와 sume jobs result로 Job을 여전히 복구할 수 있습니다.

미디어 URL은 왜 거부됐나요?

Avatar 미디어 필드는 공개 HTTPS 이미지 URL을 받습니다. Avatar 1.0 사진 입력에는 --type photo --image-url https://...를, Avatar Video에는 --product-image https://...나 --scene-image-url https://...를 넘기세요. 문서에 나온 흔한 원인은 네 가지입니다.

URL이 HTTPS가 아닙니다.
URL이 localhost나 사설 네트워크를 가리킵니다.
응답이 이미지가 아닙니다.
URL에 쿠키, 인증 헤더, 또는 Sume가 가져오기 전에 만료되는 짧은 수명의 서명이 필요합니다.

CLI 이슈를 보고할 때는 무엇을 포함해야 하나요?

비밀 값을 가린 명령어 이름과 플래그, sume version 출력, 정리된 오류 코드와 메시지, 있다면 request id, Job 관련 문제라면 Job ID, 그리고 인증이 환경 변수에서 왔는지 로컬 설정에서 왔는지를 포함하세요.

API 키, 서명된 URL, 비공개 미디어 URL, 원본 프로바이더 페이로드, 이메일, 워크스페이스·사용자 ID는 빼세요. 결과를 공유할 때는 미디어 개수와 파일 형식을 요약하고, 전체 원격 URL 대신 로컬 파일명을 쓰고, 쿼리 문자열을 가리세요.

출처

작성자 Sume