생성 워크플로
이 문서는 영문 원고를 AI로 번역한 내용이라 표현이 어색할 수 있습니다.
CLI 생성 지원 범위
| 계열 | 오늘 CLI 제출 | 권장 경로 |
|---|---|---|
| Avatar 1.0 | sume avatars create | CLI 또는 Avatar 가이드 |
| Avatar Video 1.0 | sume avatar-videos create | CLI 또는 Avatar Video 가이드 |
| Image 1.0 | CLI 서브커맨드 없음 | Developer API |
| Video 1.0 | CLI 서브커맨드 없음 | Developer API |
| Music 1.0 | CLI 서브커맨드 없음 | Developer API |
Image/Video/Music CLI 명령어를 지어내지 마세요. Idempotency-Key와 함께
POST /v1/<family>/generate(또는 model-run 별칭)를 호출한 뒤, CLI로
폴링하거나 내려받고 싶다면 sume jobs …로 Job을 복구하세요.
호스팅 MCP의 유료 도구도 오늘은 Avatar 중심입니다. MCP 개요에서 살펴보세요.
Avatar 1.0
이 명령어는 기본 Avatar 라우트인 POST /v1/avatar-1.0/generate를 제출합니다
(레거시 model-run 별칭은 호환성을 위해 API에 남아 있습니다). --type prompt,
--type photo, --type props 중에서 선택하고, 정확한 Request Body를 보내야
한다면 --payload-json이나 --payload-file을 사용하세요. 선택 옵션인
--model은 특정 경로가 필요할 때 정확한 model-run id를 받습니다.
Avatar Video 1.0
이 명령어는 POST /v1/avatar-1.0/talking-video를 제출합니다. 아바타 handle은
sume avatars list --agent --json이나
sume avatars get <avatar_id> --agent --json으로 확인하세요.
아바타 비디오 스크립트는 4~60초 범위로 추정되어야 하며, CLI가 제출 전에 이를
검증합니다.
quality는 standard, plus, max를 받습니다. 생략했을 때 CLI 기본값은
공개 API와 같은 **plus**입니다. 가장 빠른 경로가 필요하면
--quality standard를, 처리 시간보다 품질이 중요하면 --quality max를
사용하세요.
Image, Video, Music (API 우선)
curl로 Image를 제출한 뒤 CLI로 Job을 복구하는 예제입니다.
전체 요청 필드와 제약은 다음에서 살펴보세요.
제출 후 복구하기
모든 제출 명령어는 Job ID를 반환하거나 출력합니다. 유료 작업을 다시 제출하지 말고 Job 명령어로 복구하세요.
제출 명령어는 CLI가 해당 플래그를 노출하는 범위에서 정확한 페이로드, idempotency 키, 통신 모드, 웹훅 URL, 제한된 대기 타임아웃을 지원합니다.