---
title: 생성 워크플로
description: CLI로 Avatar 1.0과 Avatar Video 1.0을 제출하고, Image·Video·Music은 API로 호출하는 방법을 살펴보세요.
---

## CLI 생성 지원 범위

| 계열 | 오늘 CLI 제출 | 권장 경로 |
|---|---|---|
| Avatar 1.0 | `sume avatars create` | CLI 또는 [Avatar 가이드](/models/avatar) |
| Avatar Video 1.0 | `sume avatar-videos create` | CLI 또는 [Avatar Video 가이드](/models/avatar-videos) |
| Image 1.0 | **CLI 서브커맨드 없음** | [Developer API](/models/image) |
| Video 1.0 | **CLI 서브커맨드 없음** | [Developer API](/models/video) |
| Music 1.0 | **CLI 서브커맨드 없음** | [Developer API](/models/music) |

Image/Video/Music CLI 명령어를 지어내지 마세요. `Idempotency-Key`와 함께
`POST /v1/<family>/generate`(또는 model-run 별칭)를 호출한 뒤, CLI로
폴링하거나 내려받고 싶다면 `sume jobs …`로 Job을 복구하세요.

호스팅 MCP의 유료 도구도 오늘은 Avatar 중심입니다. [MCP 개요](/mcp)에서
살펴보세요.

## Avatar 1.0

```bash
sume avatars create \
  --confirm-paid \
  --avatar-handle studio_presenter \
  --type prompt \
  --prompt "A friendly presenter in neutral studio lighting" \
  --json
```

이 명령어는 기본 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

```bash
sume avatar-videos create \
  --confirm-paid \
  --avatar-handle sume_clawra \
  --product-image https://example.com/product.png \
  --script "Say hello to the Sume developer platform." \
  --quality plus \
  --json
```

이 명령어는 `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을 복구하는 예제입니다.

```bash
curl -sS https://api.sume.com/v1/image-1.0/generate \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"prompt":"Studio product photo on white background"}'

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

전체 요청 필드와 제약은 다음에서 살펴보세요.

- [Image 1.0](/models/image)
- [Video 1.0](/models/video)
- [Music 1.0](/models/music)

## 제출 후 복구하기

모든 제출 명령어는 Job ID를 반환하거나 출력합니다. 유료 작업을 다시 제출하지
말고 Job 명령어로 복구하세요.

```bash
sume jobs status <job_id> --agent --json
sume jobs events <job_id> --agent --json
sume jobs result <job_id> --agent --json
sume jobs watch <job_id>
sume jobs download <job_id> --output-dir ./out
```

제출 명령어는 CLI가 해당 플래그를 노출하는 범위에서 정확한 페이로드,
idempotency 키, 통신 모드, 웹훅 URL, 제한된 대기 타임아웃을 지원합니다.