Communitygithub.com

Violinet-tech/seamless-loop-video

정적 이미지를 웹 헤더나 배경용으로 매끄럽게 반복되는 앰비언트 비디오로 변환합니다. 로컬 ComfyUI에서 MiniMax H3를 사용합니다.

seamless-loop-video란 무엇인가요?

이 스킬은 정적 이미지 하나를 가져와 웹 페이지의 루핑 배경이나 히어로 비디오로 사용할 수 있는 매끄럽게 반복되는 앰비언트 클립으로 변환합니다. 로컬 ComfyUI에서 MiniMax H3 비디오 모델을 사용하며, 여러 스크립트(`make-loop.py`, `seamless.py`, `chain.py`)를 활용하여 모션을 생성하고, 실제 프레임(크로스페이드 방지)으로 루프를 닫고, 짧은 테이크를 연결하여 긴 루프를 만듭니다. 느린 모션, 눈에 띄는 접합부 등 일반적인 문제를 해결하는 방법을 설명하고, 루프 품질을 객관적으로 측정하는 방법(무손실 프레임 차분, 중앙값 프레임 단계)을 제공합니다. 결과는 Remotion이나 HyperFrames와 같은 도구로 합성되며, 최종 `<video>` 요소 구현 가이드(자동 재생, 포스터, CSS 드리프트 방지)를 포함합니다. 이 스킬은 웹사이트나 앱에 자연스럽게 움직이는 배경 애니메이션을 만드는 데 이상적입니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add Violinet-tech/seamless-loop-video

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

미리보기

스킬 README에서

문서

정적 이미지로 자연스럽게 반복되는 비디오 만들기

두 단계로 구성되며, 이를 분리하는 것이 핵심입니다:

  1. **make-loop.py**는 모션을 렌더링합니다. 루프를 만들지 않습니다.
  2. 루프는 Remotion/HyperFrames에서 합성된 실제 프레임(브리지 테이크, 컷 포인트, 또는 플로우 인비트윈)으로 닫힙니다. 방향성 모션에서 고스팅이 발생하므로 크로스페이드는 피하십시오.
  3. **chain.py**는 단일 렌더링이 길면서 빠를 수 없을 때(§5) 여러 개의 짧은 테이크를 하나의 긴 루프로 연결합니다.

세 스크립트는 scripts/ 디렉토리에 있습니다. ComfyUI가 http://127.0.0.1:8188에 있지 않으면 COMFY_URL을 설정하세요. 아래의 모든 내용은 실제로 잘못된 방법을 통해 배운 것입니다. 각 규칙에는 이를 도출한 측정값이 함께 있습니다.

python make-loop.py <image> "<prompt>" --width 544 --height 800 --length 73 --steps 8 --physics 80 --seed 11
python seamless.py  <raw.mp4> <out.mp4> --fade 20
python chain.py     <out.mp4> --fade 14 <a.mp4> <b.mp4> <c.mp4>

1. 모션 얻기

초기 렌더링에는 바람, 대기, 움직임이 전혀 없었습니다. 다음 설정들은 모두 모션을 억제하는 값으로 설정되어 있었습니다:

설정잘못된 값올바른 값이유
last_frame= first_frame생략끝을 시작 이미지에 고정하면 '시작점으로 돌아가라'는 지시가 되어, 모델이 움직이지 않음으로써 루프를 강제합니다. 이것이 가장 큰 원인입니다.
steps48터보 LoRA는 4-step으로 마케팅됩니다. 공개된 i2v 그래프는 모두 8(euler) 또는 20(res_multistep)을 사용합니다. 4는 일관된 이미지의 최소치일 뿐, 움직임을 위한 값이 아닙니다.
shift_video12.0 (노드 기본값)6.0모든 레퍼런스 워크플로우는 6을 전달합니다.
LoRA 스택turbo만turbo + wushu_spatial_physics_v2공간 물리 어댑터입니다. 천, 물, 걷는 인물에 무게를 실어줍니다.
프롬프트"gentle", "subtle", "camera perfectly still"능동적인 물리 동사미묘함을 요구하면 미묘함을 얻습니다.

다섯 가지를 모두 수정했을 때의 측정 효과 (동일한 소스 이미지):

                    before   after
median frame step     1.73  →  4.55     2.6x
cumulative movement    133  →   325     2.4x

프롬프트는 분위기가 아닌 물리학으로 작성하십시오. 무엇이 어떻게 움직이는지 구체적으로 지정하십시오: "그녀는 앞으로 걸어가고, 그녀의 머리카락과 드레스는 강한 바람에 휘날린다; 꽃잎이 찢어져 나와 빙글빙글 떨어진다; 물보라가 솟아오르고 잔물결이 진다; 안개가 땅 위로 굴러간다". "ambient", "gentle", "subtle", "slow", "camera locked"와 같은 표현은 모두 모션을 감소시키므로 피하십시오.

길이와 함정

--length는 모델의 17k+5 그리드(5, 22, 39, 56, 73 … 192, 243)에 맞춰집니다. 그렇지 않으면 노드가 자동으로 조정됩니다. 모델의 훈련 범위는 약 124-362 프레임(자체 도구 설명 기준)이므로 73은 훈련 범위 미만이고 192는 정확히 8.0초입니다.

그러나 길이가 모션을 보장하지는 않으며, 그렇게 가정하는 것은 낭비입니다. 동일한 이미지, 동일한 프롬프트, 동일한 설정에서 프레임 수만 변경했습니다:

 73 frames   median frame step 4.55   cumulative movement 325
192 frames   median frame step 1.25   cumulative movement 293

동일한 이동 거리를 2.6배의 시간 동안 — 즉 슬로우 모션입니다. 모델은 주어진 시간 동안 프롬프트가 설명하는 내용의 속도를 조절합니다. 모션-퍼-초 x 지속 시간은 특정 프롬프트에 대해 대략 일정합니다.

따라서 두 레버는 독립적이며 둘 다 필요합니다:

  • 지속 시간은 --length에서 비롯됩니다.
  • 속도는 프롬프트가 할 일의 양에서 비롯됩니다. 장면 설명("바람이 불고, 꽃잎이 날린다")은 약 3초 분량의 소재입니다. 8초로 늘리면 느려집니다.

여전히 움직이는 긴 클립을 위해서는 순차적인 비트를 작성하고 명시적으로 표현하십시오: "그녀는 앞으로 계속 걸어가며 멈추지 않는다; 강한 돌풍이 휘몰아친다; 꽃잎이 찢겨 나와 소용돌이치는 구름이 된다; 물보라가 솟아올랐다가 다시 떨어진다; 격자가 빠르게 번쩍이고 맥동한다; 안개가 휩쓸고 지나간 후 맑아진다. 첫 프레임부터 마지막 프레임까지 지속적이고 빠른 움직임, 정지나 슬로우 모션 없음."

느린 템포가 항상 잘못된 것은 아닙니다. 흐릿한 배경의 경우 과도한 움직임보다 나을 수 있습니다. 표면에 따라 판단하십시오: 히어로는 속도를 원하고, 플레이트는 드리프트를 원합니다.

192 프레임은 73 프레임의 VRAM-시간의 약 2.6배입니다: 12GB RTX 3060에서 544x800에서 662초가 소요되며, 1.7GB의 여유 공간이 있었습니다. 길이를 맞추기보다 해상도를 낮추십시오.

사용하는 모델 (모두 로컬, ComfyUI에 설치 필수)

UNET    minimax_h3_fl_or_ref2va_w4a8_pruned_a.safetensors
LoRA 1  minimax_h3_fl2v_turbo_4step_v1.2_768p.safetensors      1.0
LoRA 2  Minimax H3\wushu_spatial_physics_v2_1000_pruned.safetensors  0.8
CLIP    minimaxH3Fl2vaPruned_fl2vaPrunedFp8Scaled_txt.safetensors   type "minimax"
VAE     minimax_h3_video_vae_fp16.safetensors

12GB 카드에서 텍스트 인코더로 qwen3vl_32b_minimax_h3_nvfp4_awq를 사용하지 마십시오. 위의 fp8 pruned 버전이 적합합니다. RTX 3060에서 608x896 해상도로 73프레임 클립당 약 5.5분이 소요됩니다.


2. 루프 닫기: 크로스페이드보다 실제 프레임 선호

페이드 또는 크로스 디졸브는 방향성 모션(걷는 인물, 떠다니는 안개)이 있는 모든 것에 고스팅 현상을 일으킵니다. seamless.py와 chain.py는 크로스페이드를 사용하므로 빠른 옵션으로 취급하고, 품질이 중요할 때는 하드 컷(Remotion, HyperFrames, ffmpeg, 비디오 편집기)을 제공하는 모든 합성 도구를 사용하여 실제 프레임으로 이음새를 만드십시오:

  1. 브리지 테이크 (권장). first_frame = 루프 클립의 마지막 프레임, last_frame = 첫 번째 프레임으로 설정하여 두 번째 MiniMax H3 클립을 렌더링합니다. Remotion 또는 HyperFrames에서 하드 컷으로 A + 브리지를 결합합니다. 모션이 랩을 전달합니다. 디졸브는 없습니다.
  2. 실제 루프 포인트 선택. 클립에서 중앙값 프레임 단계의 약 1.5배 이내에 있는 늦은/이른 프레임 쌍을 검색하고 그곳에서 컷합니다.
  3. 모션 보정 인비트윈(옵티컬 플로우: RIFE/FILM, ffmpeg minterpolate mci, 또는 Resolve Speed Warp)은 종료-시작 간격이 작은 경우에만 사용하고, 큰 간격에서는 모핑됩니다.

Remotion 또는 HyperFrames(하드 컷, <Loop>/루핑 컴포지션)에서 최종 루프를 구성하고 내보낸 후, 섹션 3에서와 같이 랩을 측정하십시오.

3. 측정 — 모든 실수가 발생한 곳

세 가지 별개의 측정 버그로 인해 괜찮은 루프가 각각 거부되었습니다. 루프가 "실패"하면 다시 렌더링하기 전에 측정을 의심하십시오.

이음새를 클립 자체의 프레임 단계 분포와 비교하십시오. 0이나 단일 샘플과 비교하지 마십시오. 이음새는 주변 변화보다 크지 않을 때 보이지 않습니다.

  1. 단일 중간 클립 샘플은 "정상"이 아닙니다. 모션은 고르지 않습니다. 중간이 종종 조용한 부분입니다. 한 번의 전환을 샘플링하면 랩이 실제로 가장 큰 점프였던 클립이 통과되었습니다. 모든 내부 단계를 한 번에 읽으십시오: ffmpeg -vf "tblend=all_mode=difference,signalstats,metadata=print".
  2. 백분위수만으로는 좁은 분포에 대해 가혹합니다. 중앙값보다 27% 높은 이음새가 98번째 백분위수에 위치할 수 있지만 여전히 가장 큰 일반 단계보다 작을 수 있습니다. 두 가지 모두로 판단하십시오: 관찰된 범위 내 그리고 중앙값의 약 1.5배 이내.
  3. 무손실 인코딩을 측정하고, 배포된 파일은 측정하지 마십시오. 출력의 프레임 0은 I-프레임입니다. 이웃은 P-프레임이므로, 이에 대해 차분을 구하면 두 이미지 위에 두 개의 인코딩이 측정됩니다.
    same loop, lossless : seam 2.99
    same loop, CRF 26   : seam 4.65    <- 1.66 of pure codec
    
    신호: 클립을 트리밍해도 숫자가 변하지 않습니다. 내용과 무관한 상수 = 아티팩트, 내용이 아님.

seamless.py는 이제 측정 전용으로 무손실 트윈을 만들고 CRF 26 파일을 제공합니다. 판결 라인은 읽어야 할 부분입니다.

metadata=print에는 -v info가 필요합니다

info 레벨로 로그를 기록하므로 -v error는 측정이 읽는 유일한 출력을 조용히 제거하고 모든 숫자는 nan을 반환합니다.


4. 랩이 실제로 실패할 때

무손실 수정 후 SEAM VISIBLE은 방향성 모션(한 방향으로 걷는 인물, 축적되는 안개)을 의미하며 더 긴 --fade로는 해결되지 않습니다. 확인됨: 16, 24 및 30의 페이드는 모두 이음새를 변경하지 않았습니다.

선호도 순서:

  1. 루프를 짧게 — 단, 코덱 때문인지 확인한 후에만(위 참조). 소스 프레임이 적을수록 누적 드리프트가 줄어듭니다. 이는 길이 규칙과 상충됩니다: 루프가 짧을수록 페이드가 더 자주 발생하므로, 클립이 이미 약 6초 미만인 경우 트리밍보다는 프롬프트 재작성을 선호하십시오.
  2. 단방향 모션 대신 순환 모션에 대한 프롬프트 재작성 — 돌풍, 소용돌이치는 꽃잎, 잔물결, 맥동하는 빛. 걷기와 쌓이는 안개를 제거하십시오.
  3. 더 길게 렌더링(243프레임)하여 루프를 찾을 수 있는 더 많은 재료를 확보하고, 더 넓은 페이드가 비용 면에서 적은 비율을 차지하도록 합니다.

5. 길고 빠름: 짧은 테이크 연결

하나의 렌더링으로 둘 다를 얻을 수는 없습니다 — 위의 길이 섹션을 참조하십시오. chain.py는 여러 개의 짧고 빠른 테이크를 연결하여 각 클립의 꼬리를 다음 클립의 머리로 크로스페이드하고, 순환적으로, 랩이 한 클립의 연속 프레임에서 닫히도록 합니다.

segment[i] = crossfade(clip[i-1] tail K, clip[i] head K) ++ clip[i][K : F-K]
output length = N x (F - K)

14프레임 페이드가 있는 세 개의 73프레임 테이크는 약 7.4초를 제공합니다. 측정 결과, 시드 7 / 11 / 23 / 41의 동일한 이미지에 대한 세 개의 테이크는 모두 중앙값 4.36-5.04 범위 내에 있으므로, 테이크는 세부 사항은 다르지만 에너지는 상호 교환 가능합니다.

이것은 또한 지루하게 느껴지는 루프에 대한 실제 수정 사항입니다. 2.2초 루프는 분당 27번 반복됩니다. 눈이 포착하는 것은 이음새가 아닙니다(깨끗하게 측정됨) — 동일한 푸티지의 반복입니다. 다른 테이크는 반복을 제거합니다. 결합은 진정으로 다른 내용 사이의 디졸브가 되어, 끊김이 아닌 전환으로 읽힙니다.

모든 클립의 크기가 같아야 합니다. blend는 Error reinitializing filters!와 함께 실패하며, 원인이나 파일을 알려주지 않습니다. chain.py는 사전에 확인하고 거부하며 크기를 조정하지 않습니다 — 크기가 일치하지 않으면 어떤 렌더링이 함께 속하는지에 대한 실수를 의미하며, 하나를 늘리면 숨겨집니다.

해상도는 모션에 비용이 들지 않습니다: 544x800은 608x896과 동일하게 측정되었습니다. 따라서 체인을 작게 렌더링하고 예산을 테이크에 사용하십시오.

6. 당신이 만들지 않은 루프

확인하십시오. loop가 설정된 이미 사용 중인 에셋이 반드시 루프인 것은 아닙니다: 한 프로젝트에 사용된 손과 꽃 배경은 중앙값 단계 4.65에 대해 29.95의 랩을 측정했습니다 — 6.4배 점프로, 사용된 모든 곳에서 눈에 띄게 컷팅되고 있었습니다. seamless.py는 다시 렌더링하지 않고 4.98로 수정했는데, 크로스페이드는 파일만 필요하기 때문입니다.

7. 페이지에 배치하기

<video class="plate" id="plateLoop" autoplay loop muted playsinline
       preload="auto" poster="assets/still.webp" aria-hidden="true">
  <source src="assets/loop.mp4" type="video/mp4">
</video>
  • autoplay만으로는 충분하지 않습니다. iframe 내에서 자동 재생 권한 없이, 그리고 페이지에 사용자 활성화가 있기 전에는 자동으로 거부됩니다. 거부 시 포스터가 남아 아무도 애니메이션을 만들지 않은 정지 이미지처럼 보입니다. canplay 및 첫 번째 pointerdown/keydown/scroll/touchstart에서 재시도하고 prefers-reduced-motion에서는 일시 중지하십시오.
  • poster는 선명한 정지 이미지를 전달하므로 차단된 자동 재생이나 느린 연결에서도 원본 아트가 표시되고 검은 화면이 표시되지 않습니다.
  • 동일한 요소에서 CSS 드리프트/ken-burns 효과를 제거하십시오. 두 가지 경쟁 모션이 발생하고, 변환은 업스케일 소프트니스를 증폭시킵니다.
  • 1920 뷰포트를 덮는 600px 너비 클립은 약 3배 업스케일이며 정지 이미지보다 눈에 띄게 부드럽습니다. 스크림 아래에서는 허용 가능합니다. 선명한 전체 너비 헤더를 위해서는 20단계와 res_multistep으로 약 900px+에서 렌더링하십시오.

예산: CRF 26에서 2.2초 클립당 약 500KB.

관련 스킬