미니어처 빌드 & 디오라마 영상 생성
늦은 밤: 성냥갑 크기의 일본식 콘비니(편의점)가 호박색으로 빛납니다. 카메라는 어둠 속에서 그곳을 향해 천천히 다가갑니다—보케(bokeh)가 세상을 집어삼키는 동안 유리문, 선반, 그리고 작은 형광등은 선명하게 유지됩니다. 그 '작지만 진짜 같은' 몰입감이 이 스킬이 목표로 하는 감성적 훅(hook)입니다.
콘비니, 비 내리는 국수 가게, 사이버펑크 작업실—또는 완성된 빌드 사진: 한 줄 또는 한 장의 이미지 → 클립.
의존성: WERYAI_API_KEY + Node.js 18+. CLI를 실행할 때 **scripts/video_gen.js**가 존재해야 하며; WERYAI_VIDEO_API.md 가 resources/ 아래에 존재해야 합니다 (게시 또는 사전 사용 어셈블리를 통해 둘 다 제공). 전체 명령어와 JSON 필드는 **resources/WERYAI_VIDEO_API.md**를 참조하세요. 다른 Cursor 스킬은 필요하지 않습니다. 기본 매개변수와 모델 계층은 아래 표에 있으며; 실시간 API 제한은 weryai 모델을 따릅니다. 설치하거나 실행하기 전에 번들된 video_gen.js를 검토하여 요구 사항을 충족하는지 확인하세요. 특히 이미지-투-비디오 요청을 위해 로컬 파일 사용을 허용하는 경우 이 스크립트가 로컬 파일을 어떻게 처리하는지 주의 깊게 살펴보고, 이 동작이 스킬의 의도된 워크플로와 일치하는지 확인하세요.
레지스트리 메타데이터: 유일한 필수 런타임 시크릿은 **WERYAI_API_KEY**입니다. 이는 YAML frontmatter에 최상위 requires.env (루트 키만 평탄화하는 도구를 위한 플로우 매핑), metadata.openclaw.primaryEnv, 및 metadata.openclaw.requires.env 로 나타납니다. 스킬 디렉토리와 레지스트리는 설치자가 다운로드 전에 이를 볼 수 있도록 해당 요구 사항을 먼저 표면화해야 합니다. 패키지 내에 키를 절대 커밋하지 마세요.
설치 또는 WERYAI_API_KEY 설정 전 확인 사항
- 신뢰: WeryAI를 신뢰하고 프롬프트와 이미지 입력(URL 및 사용 시 업로드된 바이트)이 네트워크를 통해 WeryAI의 서버로 전송된다는 점을 수락하는지 확인하세요.
- 민감한 콘텐츠:
prompt에 시크릿을 넣지 마세요. 공급자 측 처리를 수락하지 않는 한 민감하다고 생각되는 이미지 URL 또는 로컬 파일을 제공하지 마세요. - 먼저
--dry-run실행: 키를 설정하기 전에node scripts/video_gen.js wait --json '…' --dry-run(및/또는--dry-run과 함께submit-*)을 실행하여 JSON 형태를 검사하세요;--dry-run만 하는 경우WERYAI_API_KEY가 필요하지 않습니다 (WERYAI_VIDEO_API.md참조). - 출처: 패키지 작성자를 확인할 수 없거나 엄격한 데이터 제어가 필요한 경우
WERYAI_API_KEY를 설정하지 마거나 격리된 / 테스트 환경에서만 실행하세요.
환경 변수 (번들된 video_gen.js)
- 실제 API 호출에 필요: 오직
WERYAI_API_KEY만 필요 (모델, 생성,status, 로컬 이미지 업로드).--dry-run만 하는 경우에는 필요하지 않습니다. - 이 스크립트가 읽지 않음: 환경 변수는 API 호스트 이름을 재정의하지 않습니다;
https://api.weryai.com와https://api-growth-agent.weryai.com는 코드에 고정되어 있습니다 (보안 참조). URL 재정의 노브(knob)가 있을 것으로 기대하지 마세요—이 빌드에는 없습니다. - 폴링(Polling):
wait는 스크립트에 고정된 지수 백오프 및 타임아웃 상수를 사용합니다 (WERYAI_VIDEO_API.md참조). 이 패키지에는 별도의 폴 환경 변수가 없습니다.
스크립트와 스킬 기본값의 차이 (JSON 일치 필수)
model: CLI에는 내장된 기본 모델이 없습니다. JSON에서model이 없거나 비어 있으면video_gen.js는MISSING_PARAM(no default model)을 반환합니다. 이 스킬의 표에서 권장하는 기본값은KLING_V3_0_PRO입니다—사전 제출 테이블과 일치하도록wait/submit-*JSON에"model":"<확인된 키>"를 항상 명시적으로 전달하세요.resolution:KLING_V3_0_PRO(이 스킬의 기본 계층)의 경우, JSON에서resolution을 완전히 생략하세요—이 필드를 지원하지 않는 모델에 대해 전송하면1002/ 매개변수 오류가 발생할 수 있습니다. 선택한 모델이node scripts/video_gen.js models에 이를 나열하고 사용자 확인 테이블에 명시적으로 포함된 경우에만resolution을 추가하세요.
사전 요구 사항
video_gen.js를 실행하기 전에 환경에WERYAI_API_KEY가 설정되어 있어야 합니다.- Node.js 18+ 가 필요합니다. 공개
https이미지 URL을 선호하세요. 조립된scripts/video_gen.js가 로컬 파일 경로를 지원하는 경우, 먼저 스크립트를 검토 및 확인하고, 로컬 이미지를 읽어 WeryAI에 업로드하여 공개 URL을 얻기 전에 명시적인 동의를 얻으세요. - 각 성공적인
wait실행은 WeryAI 크레딧을 소비합니다; 재실행 시 새로운 유료 작업이 생성됩니다.
보안, 시크릿 및 API 호스트
WERYAI_API_KEY: 시크릿으로 취급하세요. 이 스킬의 출처를 신뢰하는 경우에만 구성하세요; OpenClaw 메타데이터에requires.env/primaryEnv로 나열되어 설치자가 런타임에 필수적임을 알 수 있습니다 (스킬 패키지 내에 절대 커밋하지 마세요).- API 호스트 (
video_gen.js에 고정됨): 비디오 작업은https://api.weryai.com을 사용합니다; 모델 목록은https://api-growth-agent.weryai.com을 사용합니다. 번들된 스크립트는 이러한 기본 주소를 코드에 고정합니다—인증을 위해 오직WERYAI_API_KEY만 환경에서 읽습니다. API 호스트 이름을 변경하기 위해 어떤 환경 변수에도 의존하지 마세요; 요청은 해당 공식 엔드포인트와 로컬 이미지가 업로드될 때 문서화된 업로드 URL로만 전송됩니다 (WERYAI_VIDEO_API.md참조). - 로컬 이미지 처리 공개: 공개
https이미지 URL을 선호하세요. 조립된scripts/video_gen.js가 로컬 파일 경로를 지원하는 경우, 로컬 이미지를 읽어 WeryAI에 업로드하여 공개 URL을 얻을 수 있습니다; 해당 경로를 사용하기 전에 검토/확인 및 명시적 동의가 필요합니다. - 원격 처리: 유료 실행은
prompt와 이미지 입력을 WeryAI로 보냅니다;## 설치 또는 WERYAI_API_KEY 설정 전 확인 사항을 참조하세요. - 더 높은 보증:
## 설치 또는 WERYAI_API_KEY 설정 전 확인 사항을 따르세요; 유료 실행을 위해 단기 또는 격리된 환경을 사용하세요; 프로덕션 사용 전에scripts/video_gen.js(HTTPS 제출 + 폴 루프)를 검토하세요. 런타임이 로컬 이미지 파일을 읽어 WeryAI에 업로드할 수 있는지 확인하고, 해당 경로를 사용하기 전에 명시적 동의를 얻으세요.
프롬프트 확장 (필수)
video_gen.js는 프롬프트를 확장하지 않습니다. 모든 wait --json 전에, 사용자의 짧거나 모호한 요청을 완전한 영어 제작 prompt 로 변환하세요.
시기: 사용자가 키워드, 한 줄, 또는 느슨한 의도만 제공하거나—더 풍부한 영상 언어를 요청하는 경우. 예외: 사용자가 모델의 prompt_length_limit 내에서 긴 프롬프트를 완성하여 붙여넣고 재작성하지 말 것을 요청한 경우; 그래도 확인 테이블에 전체 텍스트를 표시하세요.
항상 추가 (영상 언어): 샷 스케일과 각도; 카메라 움직임 또는 고정; 빛의 질과 동기; duration에 맞춰진 피사체 동작; 이 틈새 시장을 위한 하나의 명확한 페이오프(payoff); 이 스킬이 기본적으로 세로형일 때 9:16 세로임을 명시하세요.
길이: 이 문서가 나열할 때 선택한 model_key의 prompt_length_limit을 준수하세요; 핵심 동작, 렌즈 또는 조명 절을 제거하기 전에 불필요한 형용사를 다듬으세요.
확인: 사전 제출 테이블에는 전체 확장 prompt 가 포함되어야 합니다 (한 줄 요약 금지). 확인 또는 수정을 기다리세요.
틈새 시장 체크리스트
- 미니어처 세계: 얕은 심도(DOF), 실용적인 따뜻한 조명, 돌리/푸시인 리빌; 디오라마 또는 상자 속 방.
- 비트(Beats): 빌드 → 페인트 → 조명 켜짐 또는 차량 통과; 아늑한 분위기, 촉각적 재료.
- 스케일 단서: 필요 시 성냥개비, 동전 또는 손가락 끝 참조.
### 예시 프롬프트 는 이 파일 상단에 있는 짧은 트리거일 뿐입니다—항상 사용자의 실제 요청에서 확장하세요.
워크플로
- 사용자 요청이 이 스킬의 시나리오(문서화된 텍스트-투-비디오 및/또는 이미지-투-비디오)와 일치하는지 확인하세요.
- 사용자의 요청, 선택적 이미지 URL, 계층 (best / good / fast) 또는 명시적
model키를 수집하세요. - 프롬프트 확장 (필수): 사용자가 완성된 긴 프롬프트를 제공하고 재작성하지 말라고 명시적으로 요청하지 않는 한, 아래
## 프롬프트 확장 (필수)를 사용하여 요청을 완전한 영어 제작prompt로 확장하세요. 사용자의 최소 단어만으로 API를 호출하지 마세요. - 확장된
prompt를 이 문서의 고정된 표(있는 경우)에서 선택한 모델의prompt_length_limit과 비교하여 확인하세요; 필요한 경우 줄이세요. duration,aspect_ratio,generate_audio,negative_prompt및 기타 필드를 이 문서의 고정된 표와WERYAI_VIDEO_API.md에 대해 확인하세요. 선택한model이 지원하는 경우에만resolution을 포함하세요 (이 스킬의 기본 KLING 계층의 경우resolution을 보내지 마세요—## 스크립트와 스킬 기본값의 차이참조).- 전체 확장
prompt를 포함한 사전 제출 매개변수 테이블을 보여주세요; 확인 또는 수정을 기다리세요. - 확인 후, 확장된 프롬프트와 함께
node scripts/video_gen.js wait --json '...'를 실행하세요. - stdout JSON을 파싱하고 비디오 URL을 반환하세요; 실패 시
errorCode/errorMessage를 표시하고 매개변수 수정을 제안하세요.
CLI 참조
node scripts/video_gen.js wait --json '{"model":"…","prompt":"…","duration":5,"aspect_ratio":"9:16"}'
node scripts/video_gen.js wait --json '…' --dry-run
node scripts/video_gen.js status --task-id <id>
전체 참조: WERYAI_VIDEO_API.md.
완료 조건
사용자가 API 응답에서 재생 가능한 비디오 URL을 하나 이상 받거나, 명확한 실패 설명과 다음 단계를 받았을 때 완료됩니다. 사용된 모든 매개변수는 이 문서에서 선택한 모델의 허용 집합 내에 있어야 합니다. 제출된 prompt는 사용자가 완성된 긴 프롬프트를 명시적으로 제공하고 재작성하지 말라고 요청하지 않는 한 확장된 제작 프롬프트여야 합니다.
범위 (범위 외)
- 플랫폼 규정 준수, 저작권 또는 초상권을 검토하지 않습니다; 출력물의 상업적 사용 가능성을 보장하지 않습니다.
- WeryAI 외 오프라인 렌더링, 기존 편집 타임라인 또는 이 SKILL 또는
WERYAI_VIDEO_API.md에 문서화되지 않은 API 필드 조합을 제공하지 않습니다. weryai-model-capabilities.md또는 공유../references/경로에 연결하지 마세요; CLI/API 세부 정보는resources/WERYAI_VIDEO_API.md를 사용하세요.- 스킬 문서에 절대 경로를 하드코딩하지 마세요;
node scripts/...를 스킬 패키지 루트(SKILL.md가 포함된 디렉토리)에서 실행하여scripts/및resources/경로가 확인되도록 하세요.
예시 프롬프트
손으로 만든 미니어처 카페: 마지막 비트에서 내부 조명 켜짐, 따뜻한 필 라이트, 느린 푸시, 세로이 거리 디오라마 사진 사용: 작은 자동차가 지나가고, 상점 창문이 밝아짐베이스 위에 칠해진 모델, 회전 리빌, 초극도 얕은 심도미니어처 빌드 리빌 9:16, 아늑한 따뜻한 조명이 작은 집 내부에서 켜짐
기본 매개변수
| 필드 | 값 |
|---|---|
| 모델 | KLING_V3_0_PRO (JSON에 "model"로 나타나야 함—스크립트는 기본값을 설정하지 않음) |
| 종횡비 | 9:16 (고정 세로) |
| 지속 시간 | 짧음 (duration: 5); 더 긴 빌드 패스를 위해 10 사용 |
| 해상도 | KLING 기본값의 경우 생략 (JSON에 키를 포함하지 마세요) |
| 스타일 | 매우 얕은 심도, 믿을 수 있는 재질, 히어로 소품에 강조 조명, 느린 푸시 또는 미묘한 궤도 (고정) |
| 오디오 | 켜짐 (몰입감을 위한 방음 + 작은 소품 디테일) |
API 유효성 (기본
KLING_V3_0_PRO): 텍스트-투-비디오duration은 5 / 10 / 15 만 가능;aspect_ratio는 9:16, 1:1, 16:9 만 가능. 이미지-투-비디오aspect_ratio는 9:16, 16:9, 1:1 만 가능.resolution필드 없음—보내지 마세요. VEO가 포함된 fast 계층의 경우: 텍스트-투-비디오VEO_3_1_FAST, 이미지-투-비디오CHATBOT_VEO_3_1_FAST,duration은 8로 고정,aspect_ratio는 9:16 또는 16:9 만 가능.model_key를 전환할 때는 이 섹션의 모델/API 제약 조건과 위의 API 유효성 참고 사항의 허용 집합을 따르세요;resolution을 지원하지 않는 모델에 보내지 마세요.
장면 설명 → 미니어처 세계
목적: 구체적인 장면 아이디어, 빠른 시각적 테스트 또는 분위기 변형 배치—실제 모델 필요 없음.
입력:
장면 유형 (콘비니 / 주방 / 별장 / 코너 가판대 / 작업실 / 사이버 세트) 및 분위기 (따뜻한 힐링 / 네온 사이버 / 낮 / 비 오는 호박색). 분위기가 생략되면 해당 장면에 일반적으로 잘 어울리는 조명을 선택하세요. 선택적으로 빌드 과정 대 완성된 투어를 강조하세요.
핵심 소품과 조명을 추출하고, "이걸 원해"라는 느낌을 주는 각도를 선택하고, 프롬프트를 작성하고, 전체 매개변수를 보여주고, 확인을 기다린 후 node scripts/video_gen.js wait --json '…'를 실행하세요.
생성 전에 전체 매개변수가 표시됩니다; 확인을 기다리세요.
매개변수 구성:
| 필드 | 값 |
|---|---|
| model | KLING_V3_0_PRO |
| aspect_ratio | 9:16 |
| duration | 5 |
| generate_audio | true |
| resolution | (생략—이 모델의 경우 보내지 마세요) |
입력 예시:
"밤의 일본 콘비니, 따뜻한 힐링" → 스킬이 다음을 구축:
극단적인 클로즈업 매크로 샷, 눈높이, 어두운 표면 위에 손바닥 크기의 미니어처 일본 편의점 디오라마, 따뜻한 호박색 실내 조명이 작은 미닫이 유리문과 성에 창문을 통해 은은하게 비치며 완벽하게 디테일한 내부를 밝힙니다 — 엄지 손가락 크기의 제품 패키지로 가득 찬 미니어처 선반, 작은 계산대, 소프트박스 천장 패널. 카메라는 30fps로 입구를 향해 매우 천천히 돌리 인(dolly in)하며 걸어가는 듯한 느낌을 주고, 얕은 심도는 상점 전면만 면도날처럼 선명하게 유지하고 주변의 어둠은 사라집니다. 차가운 파란색 야간 주변광이 외부를 채우며 문지방에서 따뜻함-차가움 색상 분할을 만듭니다. ASMR 부드러운 주변 윙윙거림, 먼 도시 야간 소리, 희미한 실내 배경 음악.
"사이버펑크 작업실, 네온" →
중간 클로즈업, 45도 오버헤드 각도, 신발상자 크기의 미니어처 사이버펑크 스튜디오 디오라마 — 작은 빛나는 모니터, 케이블로 덮인 책상, 분홍색과 청록색의 네온 조명 선반, 키보드 앞에 미니어처 액션 피규어. 카메라는 60fps로 단일 부드러운 회전으로 장면 주위를 천천히 궤도 선회하며, 네온 불빛이 모든 작은 반사 표면—모니터 베젤, 커피 머그, 윤기 나는 바닥 타일—에서 굴절됩니다. 네온 튜브의 체적 광선이 장면 위에 부드러운 안개를 만듭니다.
…
[번역을 위한 생략]