패키지 만들기 — 단계별 가이드

시작 전에 알아 둘 것

• 패키지 = 모듈을 이은 순서도. 단계마다 모듈 하나가 실행되고, 각 단계의 출력 JSON이 다음 단계의 입력이 됩니다.
• 사용자 입력은 시작 단계만. “처음 입력” 폼의 값은 시작 단계만 받습니다. 나머지 단계의 입력은 앞 단계 출력으로 고정되어 고칠 수 없습니다.
• 산출물 공유. 모든 단계가 만든 파일은 files/<단계>/… 목록으로 뒤 단계에 전달되고, 회원 폴더 안의 프로젝트 폴더(회원/projects/<프로젝트>/<단계>/)에 저장됩니다.
• 제작 중 → 출시. 새 패키지는 제작 중(비공개)으로 시작하고, 검사를 통과하면 출시합니다.
• 비용. 제작비 = API 사용요금 + 패키지 작성자의 유료 모듈 사용료(정상 완료한 실행마다) + 비디아 제작 수수료(프로젝트 1건마다, 영상 3분 이하 200P · 3분 초과~10분 500P · 10분 초과 1000P). 비디아 기본 모듈은 사용료가 없고, 패키지에는 내 모듈과 비디아 모듈만 넣을 수 있습니다.

1. 샘플 패키지 가져오기

1. 샘플 패키지 · 제작 전 과정 체험을 엽니다. 대본 → 평가·개선 → 음성 → 장면 첫 이미지 → 검수 → 클립 → 자막 → 렌더까지 모든 단계가 들어 있습니다.
2. 가져와 고치기를 누르면 내 사본이 제작 중(비공개)으로 만들어지고 빌더가 열립니다.
3. 처음부터 만들고 싶다면 패키지 만들기로 빈 빌더를 엽니다.

2. 패키지 정보 쓰기

• 제목: 무엇을 만드는 패키지인지(형식·주제·특징). 예: “공학 숏츠 · AI 이미지”.
• 요약: 한두 문장으로 결과물과 과정.
• 형식: 숏츠(세로 9:16) 또는 롱폼(가로 16:9, 12~20분). 형식이 화면 비율을 정합니다.
• 태그·노하우: 이 패키지를 잘 쓰는 법, 비용 구성, 주의할 점. 패키지 상세에 그대로 보입니다.

3. 처음 입력 만들기

1. “처음 입력” 탭에서 사용자가 제작할 때 채울 칸을 추가합니다. 종류: 한 줄 글, 여러 줄 글, 숫자, 선택, 내 자료(파일) 등.
2. 키는 영문 소문자·숫자·밑줄로 짓습니다. 시작 단계 모듈은 input.<키>로 읽습니다. 시작 모듈 지시서의 [입력]과 키 이름을 맞추세요.
3. 필수 칸(보통 주제)을 하나 이상 두고, 기본값과 도움말을 적습니다. 빌더의 입력·출력 흐름은 기본값으로 시작 입력 예시를 만듭니다.
4. 이 입력은 시작 단계만 받습니다. 중간 단계에는 입력 칸을 둘 수 없습니다.

4. 단계 추가·순서

1. 단계 추가로 모듈을 고릅니다. 모듈 카드에 “모듈 사용료 무료 · API 사용량 과금”(비디아 기본) 또는 “창작자 사용료 NP(제작 1회)”가 보입니다. 넣을 수 있는 것은 내 모듈과 비디아 모듈뿐이고, 다른 회원의 모듈은 “복제해서 쓰기”(지시서 공개 — 내 모듈로 복제한 뒤 넣기) 또는 “사용 불가”로 보입니다.
2. 맨 앞 단계가 시작입니다. 다른 단계를 시작으로 바꾸려면 인스펙터의 “이 단계부터 시작”을 누릅니다.
3. 각 단계의 끝나면 갈 단계를 정합니다. 마지막 단계는 “여기서 끝”이며, 영상 패키지라면 마지막 단계가 렌더링(최종 영상)이어야 합니다.
4. 단계 이름을 알아보기 쉽게 고치고, 메모에 이 단계의 역할을 적습니다.

5. 입력·출력 JSON 흐름 확인

1. 단계를 누르면 인스펙터에 입력 / 출력 JSON이 보입니다. 시작 단계는 처음 입력 예시에서 출발하고, 이후 단계는 앞 단계 출력이 누적된 JSON을 입력으로 받습니다.
2. 출력은 그 모듈이 선언한 출력 예시로 보여 줍니다. 예시가 없는 모듈은 “예시 없음”으로 표시됩니다. 이런 모듈은 다음 단계에 무엇이 넘어갈지 알 수 없으니 가능하면 예시가 있는 모듈을 고르세요.
3. 파일을 만드는 단계는 files/<단계>/… 항목을 추가합니다. 뒤 단계 입력의 files에 쌓이는 것을 확인하세요.
4. 다음 단계 모듈이 기대하는 필드(그 모듈 지시서의 [입력])가 앞 단계 출력에 있는지 확인합니다.

6. 조건 분기와 반복

• 조건 분기는 위에서부터 검사해 처음 맞는 곳으로 갑니다. 맞는 분기가 없으면 “끝나면 갈 단계”로 갑니다.
• 조건 종류: 에이전트 판단(route) — 모듈 출력의 route 값(예: rewrite, retry), 값 비교 — 출력 JSON 경로와 값 비교(예: evaluation.score < 60).
• 반복 예시: 대본평가 → (점수 60 미만) → 대본개선 → 대본평가. 개선 단계의 “끝나면 갈 단계”를 평가로 두면 고리가 됩니다.
• 최대 방문(1~10)이 반복 횟수를 막습니다. 한도에 닿으면 제작 설정(점수 미달 시 진행/멈춤)을 따릅니다.
• 반복되는 모듈의 사용료는 정상으로 끝난 실행 횟수만큼 받습니다. 견적에는 단계마다 최대 실행 횟수만큼의 사용료가 상한으로 잡힙니다.

7. 실행 방식

• 끝나면 멈추고 결과 확인을 켜면, 그 단계가 끝난 뒤 제작이 멈추고 사용자가 결과를 본 뒤 “계속 제작”을 눌러야 다음 단계로 갑니다. 결과는 확인만 할 수 있고 고칠 수 없습니다.
• 결과가 마음에 들지 않으면 그 단계부터 다시 실행하거나, 평가 단계의 후보 중에서 고를 수 있습니다.

8. 비용·수익 띠 읽기

• 빌더 위쪽 띠에 예상 비용 약 X~YP가 보입니다. 구성: API 사용요금 범위(모듈 지시서가 부르는 도구·AI 처리량으로 추정) + 모듈 사용료(이 패키지에 든 내 유료 모듈 — 다른 회원이 제작할 때만, 정상 완료한 실행마다) + 비디아 제작 수수료(프로젝트 1건마다, 영상 3분 이하 200P · 3분 초과~10분 500P · 10분 초과 1000P).
• 실제 금액은 제작 전 견적에서 입력값(길이·영상 비율 등)을 반영해 다시 계산하고, 승인한 최대 예산 안에서만 씁니다. 남은 예산은 돌려받습니다.
• 내 모듈 수익: 이 패키지에 든 내 유료 모듈이 다른 회원의 제작 1편에서 단계마다 한 번씩 실행될 때 벌어 주는 금액(수수료 30% 제외)입니다. 본인 제작에는 사용료가 없습니다.

9. 검사 탭

• 연결 구조(끊긴 단계·도달할 수 없는 단계·끝 없는 고리), 분기 논리(짝 없는 개선 단계), 모듈 공개 여부, 처음 입력(필수 칸·선택지), 최종 결과(렌더링) 여부를 봅니다.
• 문제가 있는 단계는 순서도에 빨간 표시가 붙습니다. 메시지를 누르면 해당 단계로 이동합니다.
• 오류와 경고가 모두 없어야 저장·출시할 수 있습니다.

10. 저장과 버전

• 저장할 때마다 패키지 버전이 쌓입니다. 버전 기록에서 이전 구성으로 되돌리거나 그 버전으로 제작할 수 있습니다.
• 단계에 쓴 모듈 버전은 고정됩니다. 모듈에 새 버전이 나오면 “새 버전” 표시가 붙고, 올릴지 고를 수 있습니다.

11. 시험 제작

1. 패키지 상세에서 이 패키지로 만들기를 누르고 처음 입력을 채웁니다(제작 중인 내 패키지도 나는 실행할 수 있습니다).
2. 견적을 확인하고 예산을 승인합니다. 비용을 줄이려면 AI 영상 비율 0%, 짧은 길이로 시험하세요.
3. 프로젝트 화면에서 단계별 진행을 봅니다. 제작 과정 자세히에서 단계를 누르면 에이전트 기록, 입력·출력 JSON(읽기 전용), 만든 파일을 볼 수 있습니다.
4. 문제가 있으면 모듈 지시서나 연결을 고쳐 다시 저장하고, 그 단계부터 다시 실행합니다.

11-1. 디버깅 모드

1. 패키지를 저장합니다. 디버그 실행은 저장된 지금 버전으로 돌고, 저장하지 않은 편집은 반영되지 않습니다.
2. 빌더 오른쪽 디버그 탭에서 처음 입력 JSON(처음 입력 칸의 기본값·예시로 채워져 있습니다)을 고치고, 모의(무료)·실제를 고릅니다.
3. 단계마다 중단점을 겁니다. 앞은 그 단계를 시작하기 전에 멈춰 들어갈 입력 JSON을, 뒤는 끝난 뒤 멈춰 나온 출력 JSON과 파일을 확인합니다.
4. 선택 요청 자동 처리는 기본으로 꺼져 있습니다. 끄면 실행 중 문제·확인 요청이 나온 자리에서 멈춰 값을 볼 수 있고, 켜면 일반 제작처럼 자동으로 처리합니다.
5. 디버그 실행을 누르면 디버그 콘솔이 열립니다. 멈춘 자리에서 계속(다음 중단점까지)·한 단계 실행(지금 단계 하나만)·되돌리기(고른 단계 앞으로 돌아가 같은 입력으로 다시 실행 — 앞선 결과는 기록으로 남음)를 고르고, 실행 중에도 중단점을 바꿀 수 있습니다.

• 디버그 콘솔에서 단계별 입력·출력을 순서대로 보고, 상세 실행 기록(프롬프트·턴별 응답·도구 호출·출력 검사·과금)으로 원인을 찾습니다.
• 실행마다 메모를 남기고 고정할 수 있습니다. 처음 입력·모의/실제·예산·중단점은 저장한 테스트 설정으로 두고 다시 불러옵니다. 기록·메모·테스트 설정은 패키지 버전을 올려도 그대로 이어집니다(디버그 탭의 기록은 버전별로 묶여 보입니다).
• 개발 기록(실행 추적·단계별 입력·출력 JSON)은 개인 저장공간 10GB 에 들어가지 않고, 휴지통 비우기로도 지워지지 않습니다. 디버그 실행이 만든 이미지·영상 같은 파일은 저장공간에 셉니다.

12. 산출물 폴더와 용량

• 제작하면 내 폴더 안에 프로젝트 폴더가 생기고, 단계별 하위 폴더에 산출물이 저장됩니다. 내 자료실에서 프로젝트별로 파일과 용량을 볼 수 있습니다.
• 저장공간은 회원 전체 합계로 무료 10GB, 프로 구독 100GB입니다. 가득 차면 다음 단계를 시작하지 않고 멈추며(예산 보관), 파일을 정리하거나 구독한 뒤 이어서 만들 수 있습니다.

13. 출시하기

1. 출시 조건: 검사 통과(오류·경고 없음), 패키지에 든 내 모듈이 모두 출시되어 있음.
2. 빌더의 출시하기를 누릅니다. 무료 회원은 공개로 출시되고, 구독자는 공개·비공개를 고릅니다.
3. 공개 패키지는 목록·검색에 나타나고 다른 회원이 제작하거나 가져와 고칠 수 있습니다. 소개 이미지는 자동으로 만들어집니다.

14. 비디아 완주 보조

패키지 제작은 오류가 나도 최종 영상까지 가도록 비디아가 적극 개입합니다. 결과물이 만족스럽지 못한 것은 패키지·모듈 작성자의 몫이고, 비디아는 끝까지 완주하도록 돕습니다.

• 공식 관문·검수 위반(평가 미달, 매체 비중 차이, 장면 순서·개수 차이, 낭독·자막 시각 차이, 설계 결함 표시 등) — 멈추지 않고 기록한 뒤 진행합니다.
• 영상 길이 차이 — 생성 영상이 장면보다 짧으면 마지막 화면을 정지 이미지로 유지하고, 길면 장면 길이로 자릅니다.
• 발화 넘침 — 발화가 장면이나 영상 끝을 넘으면 음성 배속을 최대 1.35배까지 올리고, 그래도 모자라면 뒤 발화를 늦추고 영상 끝을 정지 화면으로 늘려 끝까지 들리게 합니다.
• 단계 실패 — 한 번 다시 시도하고, 장면 설계가 이미 있으면 그 단계를 건너뛰고 이어 갑니다.
• 최종 영상 없음 — 렌더 단계가 최종 영상을 만들지 못하면 지금까지 만든 장면 클립·생성 영상·키프레임 이미지·음성·자막으로 비디아가 직접 합성합니다. 화면이 없는 장면은 앞 장면 화면이나 검은 화면으로 채웁니다.
• 최종 검증의 품질 문제(기술 규격 차이, 긴 검은 화면, 자막 누락 등) — 기록하고 완성합니다.

• 개입은 무료 처리(ffmpeg·코드)만 합니다. 유료 API를 새로 부르거나 추가 비용이 드는 개입은 하지 않습니다.
• 계속 막는 것: 다른 회원의 자료, 모의 자산, 권리 기록이 없는 실제 자료, 계보를 확인할 수 없는 자료, 장면 설계가 아예 없는 경우, 재생할 수 없는 최종 파일, 예산 부족.
• 개입한 내용은 모두 제작의 처리 이력에 "비디아 보조"로 남고, 회원·관리자 화면에서 볼 수 있습니다.
• 비디아가 개입해 완성한 제작은 공식 상품 출시의 합격 증거로 쓰지 않습니다.

회원은 제작을 시작할 때 "제작 중 선택 요청은 모두 자동으로 처리"(기본 켬)를 고를 수 있습니다. 켜 두면 작성자가 둔 멈춤 단계·평가 미달·단계 오류에서도 멈추지 않고 승인·건너뛰기를 자동으로 고릅니다. 설계가 없어 다음 단계로 넘길 수 없는 치명적 오류만 멈춥니다.

점검표

• □ 처음 입력 키와 시작 모듈 지시서의 input.*가 맞는다
• □ 모든 단계 모듈에 출력 예시가 있고, 다음 단계가 기대하는 필드가 앞 단계 출력에 있다
• □ 반복 고리에 최대 방문 한도가 있다
• □ 마지막 단계가 렌더링(최종 영상)이다
• □ 비용 띠의 예상 비용이 의도한 범위다
• □ 영상 비율 0%로 한 번 시험 제작했다

자주 묻는 질문