# 📦 Bulk Video System 이란 무엇인가요?

Bulk Video System이란 **CSV 파일 기반으로 대용량 템플릿 영상을 일괄 생성**하는 기능입니다. 같은 내용의 영상에서 특정 단어, 값 등을 다양하게 변경해야 하는 상황에서 **단어, 값을 변수 처리하여 개인화된 프로젝트를 자동으로 대량 생성**할 수 있는 대량 콘텐츠 자동화 기능입니다.

---

## 어떤 상황에서 Bulk Video System을 사용하나요?

**같은 포맷에서 개인화된 정보를 고객 및 시청자들에게 제공해야 하는 경우 사용하면 매우 효과적**으로 사용할 수 있습니다.

예로 100명의 고객에게 맞춤 프로모션 영상을 생성하는 경우 '고객 이름' 과 '프로모션 내용' 을 변수 처리하여 100개의 개인화된 영상을 쉽고 빠르게 제작할 수 있습니다.

### 마케팅 (B2B)

- 지역, 산업, 고객 특성 등을 변수 처리하여 개인화된 마케팅 영상을 제작할 수 있습니다.

### 세일즈

- 산업, 기업 등을 변수 처리하여 세일즈 제안 영상을 제작할 수 있습니다.

### 고객 유지

- 고객 이름, 고객 데이터, 고객 특성 등을 변수 처리하여 고객 맞춤형 영상을 제작할 수 있습니다.

---

## Bulk Video System 은 어떻게 사용하나요?

Bulk Video System을 사용하기 위해선 **원본 프로젝트와 변수 값이 포함된 Excel 파일이 필요**합니다.

### 1. 원본 프로젝트 생성하기

- AI 휴먼 선택하기: 원하는 AI 휴먼 모델, 착장을 선택합니다.

- TTS 설정: 국가/목소리를 선택합니다.

- 스크립트 작성: 개인화할 부분에  `**{{변수명}}**` 형태로 변수를 삽입합니다.

- 영상 생성: 원본 템플릿 영상을 완성합니다.

-   렌더링 기능을 활용하여 Bulk video system 신청 전, 결과물을 미리 확인한 후 신청하시는 것을 추천드립니다.

**스크립트 작성 예시**

```javascript
안녕하세요 {{customer_name}}님!

{{company_name}}에서 요청해주신 {{amount}}원 상당의
맞춤 솔루션을 {{date}}까지 준비해드렸습니다.

더 자세한 내용은 담당자 {{manager_name}}에게
연락해주시면 친절히 안내해드리겠습니다.
```

**✅ 프로젝트 생성 시 필수 확인사항**

- 변수명 검토

    - 모든 변수명의 **오탈자를 철저히 확인**해주시기 바랍니다.

    - **대소문자, 띄어쓰기, 특수문자의 정확성을 점검**해주시기 바랍니다.

- TTS 호환성 검증

    - **TTS 엔진에서 정상 발화 가능 여부를 사전 테스트**해보시길 바랍니다.

    - **발음하기 어려운 단어나 문장 구조를 점검**해주시기 바랍니다.

⚠️ **주의 사항**

- 언어 매칭: **선택한 TTS의 언어와 스크립트 언어가 다를 경우 부자연스러운 발음**이 될 수 있습니다.

- 변수 형식: 반드시 `**{{변수명}}**` 형태로 정확히 작성해야 합니다.

- 조사 사용 주의: 변수 뒤에 을/를 등의 조사를 붙이면 "철수을", "영희을" 등의 부자연스러운 문장이 생성 될 수 있으니 `**{{이름}}에게**` 또는 `**{{이름}} 고객님께**` 등의 **중립적 표현을 사용**해 주세요.

- 필터링 주의: 욕설, 비하 표현 등 부적절한 내용이 포함되어 있지 않은지 검토 부탁 드립니다.

- 발화 품질 검토: 제작한 **원본 프로젝트의 음성을 충분히 들어보시고, 자연스러운 발화와 적절한 띄어쓰기가 되어 있는지 점검**해 주시면 더욱 자연스러운 영상을 제작하실 수 있습니다.

### 2. Excel 파일 작성

[Excel 파일에서 대량 생성할 스크립트 작성하기](https://msest-my.sharepoint.com/:x:/g/personal/sjbaek_estsoft_com/Eaq7l55HE99EgdJvZFSVslcBePBwRC6AeWpHYjjtmprNDA?e=st2dIg)

Excel 파일은 Variables와  Projects, 두 개의 시트로 구성됩니다.

![Image](https://upload.cafenono.com/image/slashpagePost/20251022/132012_wRwZ1yzifn6l8edTYw?q=80&s=1280x180&t=outside&f=webp)

**2.1 Variables 시트 (변수 정의) 작성법**

- 변수명과 설명을 정의하는 시트입니다.

- 작성 규칙

    - A열: 변수명을 영문으로 작성합니다 (최대 10개) → 10개 이상 작성 필요 시 담당자에게 문의

    - B열: 변수에 대한 간략한 설명

    - 중복 변수 사용 불가: 같은 변수 명을 두 번 사용할 수 없습니다.

- 작성 예시

| **A열 (name)** | **B열 (description)** |
| --- | --- |
| customer_name | 고객 이름 |
| company_name | 회사명 |
| amount | 금액 |
| date | 날짜 |
| manager_name | 담당자명 |

![Image](https://upload.cafenono.com/image/slashpagePost/20251022/131837_NW1guDPHnFREmMFqSm?q=80&s=1280x180&t=outside&f=webp)

**2.2 Project 시트 (실제 데이터) 작성법**

- 실제 개인화 데이터를 입력하는 시트입니다.

- 작성 규칙:

    - A열: 프로젝트 타이틀 (공백 시 자동 생성)

    - B열부터: Variables 시트에 정의한 변수들의 실제 데이터를 입력합니다.

    - 빈 데이터 금지: 모든 변수에 반드시 데이터 입력이 필요합니다.

    - 연속성 유지: 열과 열 사이에 비어있는 칸이 있으면 오류가 발생할 수 있습니다.

- 작성 예시

| **A열 (title)** | **B열 (customer_name)** | **C열 (company_name)** | **D열 (amount)** | **E열  (date)** | **F열 (manager_ name)** |
| --- | --- | --- | --- | --- | --- |
| 김민수  님을 위한 영상 | 김민수 | ABC회사 | 1,500,000 | 2025년 9월 1일 | 이지현 |
| 이영희  님을 위한 영상 | 이영희 | XYZ기업 | 2,300,000 | 2025년 9월 13일 | 박상훈 |

![Image](https://upload.cafenono.com/image/slashpagePost/20251022/132041_ceJgZOkrwU36oztFGL?q=80&s=1280x180&t=outside&f=webp)

**✅ Excel 데이터 입력 시 필수 확인사항**

- 변수 일치성

    - Variables 탭과 Projects 탭의 **`{{변수명}}`**이 완전 일치해야 합니다. (필수)

    - 변수 추가/삭제 시 양쪽 탭에 동시 반영해주시기 바랍니다.

- 입력 금지 데이터

    - 욕설 및 부적절한 표현

    - 외국어 (한국 모델 기준: 한글/영어/한자만 발화 가능합니다)

    - 비정상적으로 긴 텍스트

⚠️ **Excel 작성 시 주의 사항**

- 변수 정의 필수: **Projects 시트에서 사용하는 모든 변수는 반드시 Variables 시트에 먼저 정의**되어야 하며, 미정의 변수 사용 시 오류가 발생할 수 있습니다.

- 부적절한 내용 금지: 욕설, 비하 표현 등 필터링 대상 내용을 필수적으로 사전 검토해주시기 바랍니다.

- 데이터 완성도: **모든 행의 모든 변수에 적절한 데이터를 입력**해주시기 바랍니다.

- 중복 표기 주의

    - 문제 상황 예시

```javascript
스크립트: "{{amount}}원입니다"
엑셀 데이터: "1000원" 입력
결과: "1000원원입니다" ('원' 중복 생성)
```

    - 올바른 입력

```javascript
스크립트: "{{amount}}원입니다"
엑셀 데이터: "1000" 입력
결과: "1000원입니다"
```

### 3. 신청 및 결과물 확인

**3.1 신청 방법**

- 사업부에 원본 프로젝트와 Excel 파일을 전달해주시기 바랍니다.

**3.2 결과물 확인**

- 성공 시

    - **암호화된 Excel 파일**로 결과물을 전달드립니다. (사업부 담당자를 통해 비밀번호를 별도로 안내드립니다.)

    - **각 영상 별 다운로드 링크가 포함**되어있습니다.

```javascript
안녕하세요, [고객사명] 담당자님.
STUDIO PERSO입니다.

요청해주신 Bulk Video System 영상 제작이 완료되어 안내 드립니다.

📊 작업 결과:
- 총 생성 건수: [N]건
- 성공: [N]건
- 실패: [N]건

📁 결과물 확인:
첨부된 암호화 Excel 파일을 다운로드하여
각 영상을 확인하실 수 있습니다.

문의사항이 있으시면 언제든 연락 부탁드립니다.

감사합니다.
STUDIO PERSO 드림
```

- 실패 시

    - 원본 프로젝트 수정이 필요한 경우 요청자가 **Studio에서 원본 프로젝트를 검토 후 재요청** 해주시기 바랍니다.

```javascript
안녕하세요, [고객사명] 담당자님.
STUDIO PERSO입니다.

요청해주신 Bulk Video System 작업 중 문제가 발생하여 안내 드립니다.

🔧 해결 방안:
1. STUDIO PERSO 접속
2. 해당 프로젝트 상태 확인 후 재접수 요청

📞 추가 지원이 필요하시면 담당자에게 연락 부탁드립니다.

감사합니다.
STUDIO PERSO 드림
```

---

## Bulk video system 신청 시 주된 실패 사유

- 변수명 불일치: Variables 시트와 원본 프로젝트의 스크립트 변수명이 상이한 경우

- 부적절한 내용: 욕설, 비하 표현 등 필터링 대상이 스크립트, Excel 파일에 포함된 경우

- 언어 불일치: TTS 언어와 스크립트 언어가 불일치 하는 경우

- 파일 형식 오류: Excel 형식 불일치 또는 용량이 초과된 경우

- 크레딧 부족: 전체 영상을 제작할 수 있는 만큼의 크레딧이 부족한 경우

    - 100 크레딧이 필요한 상황에서 99크레딧을 보유 중이라면 실패 처리됩니다.

---

## 크레딧 차감 안내

Bulk video system은 제작 요청주신 **전체 영상 길이에 대해 1분당 1크레딧이 차감**됩니다.

- 예로 40개의 개인화된 영상을 제작하여 **영상의 총 길이가 26분 40초가 되었다면 총 27크레딧을 소모**하게 됩니다.

- 변수 값에 따라 같은 포맷이더라도 각각의 영상 길이는 달라질 수 있습니다.

---

## 자주 묻는 질문 · 해결 방법

- **크레딧이 모자라더라도 보유 중인 크레딧 만큼만 일단 영상을 제작해줄 수 없나요?**

    - 크레딧을 **전체 영상 길이만큼 보유하고 있어야 Bulk video system이 성공적으로 처리**됩니다. 보유 중인 크레딧이 모자란 경우 **원본 프로젝트 혹은 Excel 파일을 수정하여 전체 길이를 줄여서 다시 신청하거나 사업 담당자와 협의**해보시기 바랍니다.

---

**Bulk Video System을 통해 쉽고 빠르게 개인화된 영상을 대량으로 생성해보세요!**

[STUDIO PERSO에서 영상 제작하기](https://perso.ai/ko/workspace/studio)

For the site tree, see the [root Markdown](https://community.perso.ai/.md).