🎬 star365 AI Media Studio 사용설명서

• 주소: https://video.metaquant.club/ (= studio.star365.site)
• 작성: 2026-07-26 · 개정 2026-07-27 · 수치는 개정 시점 실측값
• 대상: 영상 제작을 담당하는 star365 운영 인력

2026-07-27 개정 — ① 로그인 필수로 바뀌었습니다 ② 업로드 영상에 AI 생성 고지가 자동으로 새겨지고, 고지가 없으면 발행이 막힙니다 ③ Kaggle 노트북을 다시 받아야 업로드가 됩니다.

주제 한 줄로 스크립트 → 다국어 → 렌더 명세 → 영상 검수 → YouTube 발행까지 진행하는 영상 제작 파이프라인입니다. 영상 생성 자체는 Kaggle 무료 GPU에서 수행하고, 이 사이트는 그 앞뒤 공정을 관리합니다.

ℹ️ 서버 경로·시크릿 위치·내부 API 등 운영자용 상세는 사내 문서 /opt/star365-hq/studio/docs/USER-GUIDE.md 를 참조하세요.

---

00. 시작 전 확인

	내용
🔴 발행 = 즉시 전체공개	🚀 YouTube 발행을 누르면 비공개 대기 없이 곧바로 채널에 공개됩니다. 되돌리려면 YouTube Studio에서 직접 내려야 합니다. 시험 삼아 누르지 마세요.
🔴 삭제 복구 불가	🗑 프로젝트 삭제는 스크립트·렌더 명세·업로드 영상·발행 이력을 함께 지웁니다. 확인창 외 복구 수단이 없습니다(이미 발행된 YouTube 영상 자체는 남습니다).
🟡 담당자 전용	실제 채널에 영상을 올리는 도구입니다. 담당자 외에는 사용하지 마시고, 주소를 외부에 공유하지 마세요.
🟡 AI 고지 없으면 발행 불가	업로드 영상에 AI 생성 고지가 새겨져야 발행됩니다. 자동으로 처리되지만, 실패하면 발행 단계에서 막힙니다(→ 07-A).

로그인 (2026-07-27~)

접속하면 접근 키를 묻는 창이 뜹니다. 키를 입력하면 12시간 동안 유지됩니다.

• 키는 담당 운영자에게 요청하세요. 키를 메신저·문서에 남기지 마세요.
• star365.site에 관리자로 로그인되어 있으면 studio.star365.site 주소에서는 자동으로 인증됩니다. video.metaquant.club 주소는 도메인이 달라 키 입력이 필요합니다.
• 12시간이 지나면 화면이 비면서 다시 로그인 창이 뜹니다. 정상입니다.

현재 상태 (2026-07-27 실측)

지표	값
전체 프로젝트	371건 (컨셉 42 / 렌더명세 289 / 발행 38)
YouTube 발행	65건
업로드 영상	승인 17 · 대기 3 · 거절 53 (208MB)
AI 고지 적용 영상	6건 (나머지는 파일이 이미 정리되었거나 발행 완료분)
참조 파이프라인	14종

렌더명세 289건 = 명세만 만들고 실제 영상은 아직 만들지 않은 상태. Kaggle GPU 작업이 현재 병목입니다.

---

01. 화면 구성

첫 화면은 위에서부터 다섯 덩어리입니다.

영역	하는 일
파이프라인	7단계별 프로젝트 개수. 어느 공정에 일이 쌓였는지 한눈에 봅니다
🔎 영상 정밀 분석	이미 올라간 YouTube 영상의 품질·규제 위반을 AI가 직접 보고 점검. 제작 공정과 독립적으로 사용 가능
OpenMontage 파이프라인	참고용 제작 방법론 카탈로그 14종 — 읽기 전용이며 여기서 실행되지 않습니다
새 프로젝트	영상 한 편의 출발점
프로젝트	최근 수정순 목록. 카드를 클릭하면 작업용 상세창이 열립니다

우측 상단 뱃지가 YouTube 연동 상태입니다. 🟢 연동 = 발행 가능 / 🟡 미연동 = 발행 단계에서 막힘(운영자 조치 필요).

모든 작업은 프로젝트 카드를 열어서 합니다. 상세창은 1 · 스크립트 → 2 · 렌더 명세 → 3 · 영상 검수 → 4 · 발행 순으로 구획되어 있고, 각 구획의 버튼이 그 단계의 실행 버튼입니다. 창은 Esc · 배경 클릭 · ✕ 로 닫습니다.

---

02. 7단계 파이프라인

컨셉 → 스크립트 → 다국어 → 렌더명세 → 렌더완료 → 검수 → 발행

• 앞으로만 전진합니다. 발행까지 간 프로젝트에서 스크립트를 다시 만들어도 단계 표시는 발행에 머뭅니다. 중간 단계로 되돌리는 기능은 없으니, 처음부터 다시 하려면 새 프로젝트를 만드세요.
• 다국어는 전부 성공해야 넘어갑니다. 3개 언어 중 1개라도 실패하면 단계는 스크립트에 남고 성공한 것만 저장됩니다 — 버튼을 다시 눌러 빠진 언어만 재시도하면 됩니다.

---

03. 제작 순서

STEP 1 — 새 프로젝트 만들기

항목	필수	설명
주제 topic	✅	영상에서 다룰 내용. 최대 200자. 톤·금칙어·훅 전략 같은 지시를 여러 줄로 적어두면 스크립트 품질이 확 올라갑니다
제목 title		비워두면 주제가 제목이 됩니다
틈새 niche		카테고리. 예: 의료관광, iot
연계 상품 product		none·translate·clinic·shop·mlm. 고르면 스크립트가 그 서비스를 CTA에 자연스럽게 녹입니다
대상 언어	✅ 1개 이상	한국어·中文·English·Tiếng Việt·日本語. 맨 앞에 체크된 언어가 원본이 되고 나머지는 번역 대상입니다

＋ 프로젝트 생성을 누르면 목록에 추가되고 상세창이 바로 열립니다.

STEP 2 — 📝 스크립트 생성

AI가 다음을 한 번에 만듭니다.

• 훅(HOOK) — 첫 2초용 문장
• 장면 4~7개 — 각 장면마다 내레이션, 영어 영상 프롬프트(visual_prompt), 길이(3~10초)
• CTA, SEO 제목·설명·태그 5~12개 — 태그는 발행 시 설명란 해시태그로 자동 첨부

결과가 마음에 안 들면 다시 눌러도 됩니다. 새 스크립트가 추가되며 기존 것은 지워지지 않습니다. 다만 이후 단계는 가장 먼저 만든 스크립트를 기준으로 삼으니, 방향을 바꾸려면 주제를 고쳐 새 프로젝트로 시작하는 편이 깔끔합니다.

STEP 3 — 🌐 다국어 변형

대상 언어를 2개 이상 골랐다면 나타납니다. 원본 스크립트를 나머지 언어로 번역·현지화합니다. 이미 있는 언어는 건너뜁니다. 완료 후 언어 탭으로 각 버전을 확인하세요.

STEP 4 — 🎬 렌더 명세 생성

장면들을 영상 생성용 클립 목록으로 변환합니다. 기본값은 LTX-2.3 · 1280x720 · 24fps이고, 클립마다 화질 저하·워터마크·손가락 왜곡을 억제하는 네거티브 프롬프트와 고정 시드가 붙습니다 (시드가 고정이라 같은 명세는 항상 같은 영상이 나옵니다).

생성되면 그 줄에 ⬇ Kaggle 노트북 (.ipynb) 링크가 생깁니다. 이 파일이 다음 단계의 준비물입니다.

STEP 5 — 영상 렌더 (이 사이트 밖에서)

이 서버에는 GPU가 없습니다. 받은 노트북을 Kaggle에서 돌려 mp4를 만듭니다. → 04. Kaggle 렌더

STEP 6 — 📤 영상 올리고 검수하기

• mp4 · webm · mov, 1KB ~ 200MB. 확장자만 바꾼 가짜 파일은 내용 검사에서 걸러집니다
• 업로드하면 AI 생성 고지 자막이 영상에 자동으로 새겨집니다(→ 07-A). 자산 줄에 🏷 AI고지 가 보이면 정상입니다
• 이어서 상태는 대기(pending). 영상을 확인하고 ✅ 승인 또는 ❌ 거절
• 승인된 영상이 하나라도 있어야 발행 버튼이 켜집니다

STEP 7 — 🚀 YouTube 발행

🔴 누르는 순간 전체공개됩니다. 발행 전에 영상과 SEO 제목·설명을 반드시 최종 확인하세요.

업로드 시 자동으로 붙는 항목:

• 제목 = SEO 제목 / 설명 = AI 생성 고지문 + SEO 설명 + 해시태그 / 태그 = SEO 태그
• 카테고리 = People & Blogs, 아동용 아님
• AI 생성 콘텐츠 고지 — YouTube 정책 대응으로 항상 켜집니다

성공하면 발행 이력에 youtu.be/… 링크가 남습니다. 실패 사유도 같은 자리에 기록되니, 안 됐을 때는 그 문구로 06. 오류·제한에서 찾으세요.

---

04. Kaggle 렌더

1. Kaggle에 노트북을 업로드하고 엽니다
2. 우측 Settings → Accelerator 를 GPU T4 x2 로 지정
3. Settings → Internet 을 On 으로 (모델 다운로드에 필요)
4. Run All — 클립을 하나씩 만든 뒤 ffmpeg로 이어붙여 최종 mp4 생성
5. 마지막 셀의 curl 명령으로 완성 mp4를 Studio에 다시 올립니다 (화면에서 📤 업로드 해도 동일)

🔴 2026-07-27 이전에 받아둔 노트북은 업로드가 실패합니다(401). 로그인 도입으로 업로드에도 인증이 필요해졌습니다. 렌더 명세 화면에서 노트북을 다시 받으면 필요한 인증 정보가 이미 채워진 상태로 내려옵니다. 그 노트북에는 이 프로젝트 전용 접근 정보가 들어 있으니 공개 공유하지 마세요.

🟡 P100을 받으면 즉시 멈춥니다. 노트북 앞부분에 GPU 검사 셀이 있어, Tesla P100처럼 지원되지 않는 GPU가 걸리면 INCOMPATIBLE_GPU로 바로 중단합니다. 헛돌며 GPU 시간을 태우지 않기 위한 안전장치이니, 세션을 껐다가 다시 시작해 T4를 받으세요.

• 무료 GPU 쿼터는 주 30시간. 클립 수가 많으면 그만큼 오래 걸립니다
• 메모리 부족(OOM)이 나면 해상도를 768x512로 낮추거나, 렌더 명세를 만들 때 모델을 Wan2.2-TI2V-5B로 지정해 경량 노트북을 받으세요. 훨씬 가볍고 빠릅니다
• 클립 하나가 실패해도 나머지는 계속 진행됩니다

---

05. 영상 정밀 분석

첫 화면 🔎 영상 정밀 분석에 YouTube 주소를 넣고 정밀 점검 실행. youtube.com 또는 youtu.be 주소만 받습니다. 보통 1~3분 걸리며, 4분을 넘기면 시간 초과로 끝나니 다시 실행하세요.

AI가 영상을 실제로 보고 들으며 7개 항목을 점검합니다.

점검 항목	무엇을 잡아내는가
시각품질	해상도·구도·조명·흔들림 (good / fair / poor)
AI슬롭·아티팩트	손가락·얼굴 왜곡, 모핑, 깜빡임, 뭉개진 텍스트
화면텍스트	자막의 한글 깨짐·오타·잘림
의료·주장 위험	효능·치료·수치 과장 등 한국 의료광고 사전심의 위험 (none / low / medium / high)
AI 생성고지	영상 안에 AI 생성 표시가 있는지
자막·오디오	싱크, 발음, 음질, 어색한 TTS
브랜드 일관성	로고·색·톤, 브랜드명 철자 오기

결과는 🟢 PASS / 🟡 WARN / 🔴 FAIL 로 종합되고, 각 지적에는 가능한 한 [mm:ss] 타임스탬프가 붙습니다. 치명적 발견과 권고사항이 아래에 따로 정리됩니다.

💡 의료 관련 영상은 발행 전에 이 점검을 먼저 돌리세요. 의료·주장 위험이 medium 이상이면 스크립트를 고치는 편이 안전합니다. 사전심의 리스크는 사람이 놓치기 쉬운 지점입니다. 분석은 1분에 8회까지 시작할 수 있고, 결과는 최근 60건만 보관됩니다.

---

06. 오류·제한

화면 오른쪽 아래 토스트에 뜨는 문구별 대처법입니다.

메시지	원인	대처
topic_required	주제를 안 씀	주제 칸을 채웁니다
no_base_script	스크립트 없이 다국어 변형 시도	스크립트를 먼저 생성
no_script	스크립트 없이 렌더 명세 시도	스크립트를 먼저 생성
no_approved_asset	승인 영상 없이 발행 시도	업로드한 영상을 ✅ 승인
too_large	영상이 200MB 초과	해상도·길이를 줄여 다시 렌더하거나 압축
not_video / too_small	영상 파일이 아니거나 깨짐	mp4·webm·mov 원본인지 확인
rate_limited	같은 작업을 너무 빨리 반복	1분 기다렸다 재시도
auth_required	로그인 안 됨 / 12시간 세션 만료	접근 키로 다시 로그인
disclosure_required	AI 고지가 없는 영상으로 발행 시도	자산 줄의 🏷 고지 번인 을 누른 뒤 재시도
YouTube OAuth 미설정	서버에 YouTube 인증 정보 없음	운영자 조치 필요 (화면에서 해결 불가)
스크립트 생성 실패	AI 제공자가 모두 실패	잠시 후 재시도. 계속되면 운영자 확인
Gemini 키 미설정	영상 분석용 키 없음	운영자 조치 필요
job 없음	분석 결과가 만료됨	다시 실행 (최근 60건만 보관)

분당 요청 제한 (사용자·작업별로 각각 계산)

작업	분당 한도
YouTube 발행	10
영상 정밀 분석 시작	8
스크립트 생성 · 다국어 변형 · 렌더 명세	20
영상 업로드	30
프로젝트 생성 · 삭제 · 승인 · 거절	60
목록 · 상세 조회	120

---

07-A. AI 생성 고지

왜 하나요. 「인공지능 기본법」이 2026년 1월 22일 시행되어, 생성형 AI로 만든 결과물은 AI로 만들었다는 사실을 알려야 합니다. 일반 결과물은 눈에 보이는 표시 또는 워터마크·메타데이터 중 하나면 되지만, 실제 인물·상황으로 오인될 수 있는 영상은 눈에 보이는 표시가 필수입니다. 위반하면 시정명령이 나오고, 따르지 않으면 과태료가 부과될 수 있습니다.

이 스튜디오는 사람이 말하는 형태의 영상도 만들기 때문에 눈에 보이는 표시를 기본값으로 합니다.

세 겹으로 고지합니다

	방식	언제
①	영상에 새겨지는 자막 (눈에 보이는 표시)	영상을 업로드하는 순간 자동
②	설명란 맨 위 고지 문구	발행할 때 자동
③	YouTube의 AI 콘텐츠 표시	발행할 때 자동

자막 문구는 영상 언어를 따릅니다 — 한국어 AI 생성 영상 · English AI-generated · 中文 AI 生成视频 · 日本語 AI生成映像 · Tiếng Việt Video do AI tạo · Монгол AI-аар үүсгэсэн. 위치는 우측 상단이라 자막·본문을 가리지 않습니다. 설명란 고지문은 외국어 영상에도 한국어를 함께 적습니다(국내법 대응).

고지가 실패했을 때

업로드 자체는 성공하고, 자산 줄에 ⚠ 고지없음 이 뜹니다. 발행 단계에서만 막힙니다 — 이때 disclosure_required 오류가 납니다.

→ 자산 줄의 🏷 고지 번인 버튼을 누르세요. 대부분 여기서 해결됩니다. 그래도 실패하면 원본 mp4가 손상됐을 가능성이 높으니 다시 렌더하세요.

⚠️ 이전 영상에는 적용되지 않았습니다. 2026-07-27 이전에 발행된 영상 65건에는 이 고지가 없습니다. 영상에 새겨진 자막은 재업로드 없이 추가할 수 없습니다.

---

07. 자주 묻는 것

Q. AI가 만든 스크립트가 마음에 안 듭니다. 주제 칸에 지시를 구체적으로 적으세요. 톤, 쓰지 말아야 할 단어, 훅 전략을 여러 줄로 적으면 결과가 크게 달라집니다.

Q. 왜 영상이 사이트에서 바로 안 만들어지나요? 이 서버에 GPU가 없습니다. 영상 생성은 Kaggle 무료 GPU에 위임하는 구조라 노트북을 받아 직접 돌려야 합니다.

Q. 발행을 취소하고 싶습니다. 이 사이트에서는 불가능합니다. YouTube Studio에서 해당 영상을 직접 비공개 처리하거나 삭제하세요.

Q. 같은 영상을 여러 언어로 내려면? 프로젝트 하나에 대상 언어를 여러 개 체크하고 다국어 변형까지 돌린 뒤, 언어별로 렌더한 mp4를 각각 업로드·승인하면 됩니다.

Q. 다국어 변형이 일부 언어만 되고 멈춥니다. 번역 API의 분당 한도에 걸린 경우로, 이제 자동으로 기다렸다가 재시도합니다. 그래도 빠진 언어가 있으면 성공한 것만 저장되고 단계는 그대로 머무니, 버튼을 다시 누르면 빠진 언어만 재시도합니다.

Q. AI 고지 자막을 빼고 싶습니다. 담당자 화면에서는 불가능합니다. 법상 의무이자 발행 조건이라 자막이 없으면 발행이 막힙니다. 문구·위치 변경이 꼭 필요하면 운영자에게 요청하세요.

Q. 갑자기 화면이 비고 로그인 창이 떴습니다. 12시간 세션이 만료된 것입니다. 접근 키를 다시 입력하면 작업 내용은 그대로 남아 있습니다.

---

본 문서는 2026-07-26 실코드·실데이터 기준으로 작성되었습니다. 화면의 현재 값과 다를 수 있습니다.