모듈·패키지로 영상 만드는 법

모듈 = 스킬(txt)

모듈은 순수 텍스트 파일 하나입니다. 프로그래밍 코드는 넣지 않습니다. 사람에게 일을 맡기듯 "무엇을 받아서, 어떻게 하고, 무엇을 돌려줄지"를 한국어로 적으면 AI 에이전트가 그대로 수행합니다.

• 입력 JSON → 출력 JSON. 앞 단계가 준 JSON 을 받아 이번 단계 결과를 더해 다음 단계로 넘깁니다.
• 한 방향. 모듈은 앞에서 뒤로만 연결됩니다. 되돌아가는 반복은 패키지의 분기로 만듭니다.
• 버전. 고칠 때마다 새 버전이 쌓이고, 패키지는 특정 버전을 고정해서 씁니다. 작성자가 새 버전을 올려도 기존 패키지는 그대로 동작합니다(순서도에 v1 처럼 표시되면 더 새 버전이 있다는 뜻입니다).
• 공개 범위. 공개·비공개 중 고르고, 공개하더라도 지시서(txt 본문)는 숨기고 설명서만 보여 줄 수 있습니다.

모듈 쓰는 법

모듈 등록에서 이름·단계를 고르고 본문을 붙여 넣으면 됩니다. 본문은 아래처럼 [제목]으로 절을 나누면 에이전트가 가장 정확하게 따릅니다. 절 이름은 자유지만 이 다섯 개를 권합니다.

1. [이 모듈이 하는 일] 한두 문장 요약. 에이전트가 목적을 잡습니다.
2. [필요한 값] 회원이 패키지 설정 때 꼭 넣어야 할 값(선택). 아래 참고
3. [입력] 앞 단계 JSON 에서 읽을 필드.
4. [할 일] 번호를 매긴 절차. 도구 이름과 인자를 구체적으로 적을수록 결과가 안정됩니다.
5. [출력] 돌려줄 필드와 모양. 분기가 필요하면 route 값을 정해 줍니다.

필요한 값·API 키

모듈이 외부 서비스 키나 채널 이름처럼 꼭 있어야 하는 값을 쓰면 [필요한 값]에 적습니다. 패키지를 처음 설정할 때 이 값을 모두 넣어야 제작 버튼이 켜집니다. 여러 모듈이 같은 키를 쓰면 한 번만 묻습니다.

한 줄 형식: - 필수|옵션 | 종류 | 키이름 | 화면에 보일 이름 | 추가설정

패키지 = 제작 템플릿

패키지는 모듈을 순서대로 이은 템플릿입니다. 패키지 만들기에서 왼쪽 목록의 모듈을 눌러 순서도에 추가하고, 상자를 끌어 위치를 바꾸고, 오른쪽에서 단계 설정을 고칩니다.

• 처음 입력 칸: 제작할 때 회원이 채울 주제·말투 같은 칸. 이 값이 JSON 으로 첫 모듈에 들어갑니다.
• 단계 설정: 이름·메모·끝나면 멈춤(수동 확인)·최대 방문 수(반복 한도).
• 연결: 기본 "다음 단계" 하나와, 조건이 맞으면 다른 단계로 가는 분기 여러 개.
• 노하우: 패키지 상세에 보일 설명(마크다운). 왜 이렇게 구성했는지 적으면 쓰는 사람이 믿고 고릅니다.

분기·반복

모듈은 항상 순서대로 이어지지만, 단계가 끝났을 때 출력 JSON 을 보고 다른 단계로 갈 수 있습니다. 분기는 위에서부터 차례로 검사해 처음 맞는 것으로 가고, 하나도 맞지 않으면 "다음 단계"로 갑니다.

• route 로 고르기: 모듈이 출력에 "route": "rewrite" 처럼 적게 하고, 분기에서 route 가 rewrite 이면 대본개선으로 보냅니다. 가장 쉽고 명확합니다.
• 값으로 고르기: evaluation.score 미만 60 처럼 JSON 경로·비교·값으로 정합니다.
• 무한 반복 방지: 단계마다 최대 방문 수가 있어, 한도에 닿으면 그 분기는 건너뛰고 다음으로 진행합니다.

AI 에이전트와 프로젝트

제작을 누르면 프로젝트가 하나 생기고, 프로젝트마다 고유한 에이전트 세션이 열립니다. 에이전트는 순서도의 단계마다 다음을 합니다.

1. 그 단계 모듈 txt(스킬)와 앞 단계 출력 JSON, 회원 설정값을 받습니다.
2. 스킬대로 생각하고, 필요하면 도구를 불러 실제 파일을 만듭니다.
3. 이번 단계 결과를 JSON 으로 내고, 세션 기억에 짧은 요약을 남깁니다.
4. 분기 조건을 보고 다음 단계로 넘깁니다.

에이전트 도구

모듈 [할 일]에 아래 도구 이름을 적으면 에이전트가 그 도구를 씁니다. 유료 도구는 쓴 만큼 포인트가 나가고, 같은 입력으로 다시 부르면 저장된 결과를 돌려주어 두 번 과금하지 않습니다.

단계 사이 데이터

단계끼리는 JSON 하나를 주고받습니다. 기본 모듈은 아래 모양(vidia.doc@1)을 쓰므로, 내 모듈도 이 모양을 따르면 기본 모듈과 자유롭게 섞어 쓸 수 있습니다.

• 출력에는 이번 단계에서 바꾸거나 더한 최상위 필드만 적으면 됩니다. 적지 않은 필드는 그대로 이어집니다.
• 필드 하나를 바꿀 때는 그 값 전체를 적습니다(예: assets 는 기존 키까지). 비우려면 {} 나 null.
• route·error 는 그 단계의 판단이라 다음으로 이어지지 않습니다.

제작 비용은 포인트로 냅니다(1P = 1원, 부가세 별도). 크게 두 가지입니다.

• 제작비: 음성·이미지·영상·평가처럼 실제로 만든 만큼. 순서도 상자와 모듈 카드에 단계별 기준이 보입니다.
• 모듈 사용료: 다른 회원의 유료 모듈을 쓸 때 1회당 정해진 금액. 단계가 성공했을 때만 나갑니다.

프로젝트를 만들 때 정한 예산을 넘지 않습니다. 모자라면 멈추고 알려 주며, 이미 만든 결과는 버리지 않습니다. 내 API 키로 도는 모듈(예: 내 OpenAI 키)은 그 서비스 요금이 내 계정으로 나가고 포인트는 에이전트 처리비만 듭니다.

공개·사용료·정산

내 모듈과 패키지는 따로 공개할 수 있습니다(예: "공학 숏츠 제작 패키지", "롱폼 역사 전문 패키지", "대본평가 모듈").

• 지시서 비공개: 공개 모듈이라도 txt 본문은 숨기고 설명서만 보여 줄 수 있습니다. 실행 중 결과에 지시서 문장이 나오면 자동으로 가립니다. 비공개 지시서 모듈은 다른 사람이 복제할 수 없습니다.
• 1회 사용료: 모듈 편집에서 정합니다. 다른 회원의 프로젝트에서 그 단계가 성공할 때마다 사용료에서 플랫폼 수수료 20%를 뺀 금액이 수익 포인트로 쌓입니다.
• 정산: 수익 포인트는 제작에 쓰거나 50,000P 이상부터 10,000P 단위로 계좌 정산을 신청할 수 있습니다(사업소득 원천징수 3.3%). 판매와 수익 적립은 누구나 할 수 있고, 출금(정산)은 프로 구독 중인 판매자만 신청할 수 있습니다.
• 원작자·책임: 모듈·패키지를 등록한 회원이 원작자입니다. 다른 회원의 것을 가져와 고쳐 등록해도 등록한 회원이 원작자이며, 원본 작성자에게 따로 보상하지 않습니다. 유료 모듈 사용료(수수료 제외)는 등록한 회원에게 적립되고, 등록한 콘텐츠의 권리·내용·결과에 대한 모든 책임도 등록한 회원에게 있습니다(판매·정산 안내).

설계도

설계도는 완성 영상을 다시 만들 수 있는 모든 것(장면·대본·화면 프롬프트·음성·자막 설정·노하우)을 담은 JSON 입니다. 프로젝트가 끝나면 설계도로 공개할 수 있고, 다른 회원은 설계도 상세에서 이 설계도로 만들기를 눌러 구조는 그대로 두고 주제만 바꿔 같은 품질로 만듭니다.

형식은 설계도 문서에서 자세히 볼 수 있습니다. 다른 도구에서 만든 대본 JSON 도 설계도 등록에서 가져올 수 있습니다.