Communitygithub.com

magic-hour-image-to-video

Magic Hour의 이미지를 애니메이션화하는 도구입니다. 초상화, 캐릭터, 아트워크 또는 장면을 움직임으로 변환하며, 필요 시 시작 프레임을 검사하고 편집합니다. 이미지-투-비디오, 변환, 리빌 효과 및 캐릭터 애니메이션에 사용됩니다.

magic-hour-image-to-video란 무엇인가요?

이 스킬은 Magic Hour API를 사용하여 정적 이미지에서 짧은 비디오를 생성하는 AI 에이전트용 도구입니다. 먼저 시작 프레임의 외관을 해결한 후 모션을 적용하는 2단계 프로세스를 따릅니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, Magic Hour MCP 서버(`https://mcp.magichour.ai/`)를 통해 작동하거나 직접 API를 호출할 수 있습니다. 핵심 기능은 이미지 편집 또는 생성으로 시작 프레임을 만든 후, 승인된 프레임에 모션 프롬프트를 적용하여 비디오로 애니메이션하는 것입니다. 이 스킬은 예산 관리, 프로젝트 ID 추적, 완성된 비디오의 품질 검사(아이덴티티 유지, 워핑 없는지, 모션 방향 일치 등)를 포함한 전체 워크플로우를 자동화합니다. 실패 조건(예: 얼굴 왜곡, 로고 변경 등)을 식별하고 최소한의 수정으로 문제를 해결하도록 설계되어 있으며, 사용자 예산을 초과하지 않도록 크레딧 소비를 제어합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/magichourhq/skills/tree/main/skills/magic-hour-image-to-video

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

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

문서

Magic Hour 이미지 투 비디오

먼저 정지 프레임에서 외관을 해결하고, 그 다음 모션을 적용하여 사용 가능한 짧은 비디오를 제작합니다. 프로젝트 ID 또는 대기 중인 작업은 사용자가 제출만 요청하지 않은 한 불완전합니다.

생성 시 Magic Hour 크레딧이 소모됩니다. 사용 가능한 경우 연결된 Magic Hour 생성 MCP(https://mcp.magichour.ai/)를 사용하세요. 그렇지 않으면 references/setup.md에서 API 경로를 읽어보세요. 모델, 지속 시간, 해상도 또는 가격을 선택하기 전에 현재 스키마를 확인하세요.

브리핑에서 샷 방향을 선택하세요. 비기술적 사용자에게 모델 필드나 모션 프롬프트 템플릿을 묻지 마세요. 기존 예산을 존중하세요. 창의적 결정이 위임된 경우, 스틸 이미지를 직접 검사하고 승인한 후, 초안 승인이 요청되지 않은 경우 비디오로 계속 진행하세요. 클립을 먼저 보여주고 프로젝트에 기술 기록을 유지하세요. 변환 및 리빌의 경우 순간 연출을 읽고, 여러 비트가 있는 스토리의 경우 멀티 샷 연출을 읽으세요.

첫 번째 결과 또는 설정 복구를 위해 첫 비디오 및 다음 편집을 읽으세요. 여기에는 계정 확인, 결합 예산, 복구 가능한 작업 레코드 및 재사용 가능한 결과물이 정의되어 있습니다.

샷 정의

다음을 추출하거나 추론하세요:

  • 전달 종횡비 및 해상도
  • 주제, 제품, 캐릭터, 설정 및 필요한 시각적 세부 사항
  • 하나의 주요 주제 동작 및 하나의 카메라 움직임
  • 고정되어야 하는 세부 사항, 특히 아이덴티티, 지오메트리, 패키지, 로고, 텍스트, 색상, 의복 및 배경
  • 실패 조건(예: 일그러진 얼굴, 변경된 라벨, 원치 않는 컷, 읽을 수 없는 텍스트)

짧은 클립을 하나의 일관된 비트로 유지하세요. 사용자가 여러 샷을 원하는 경우, 각 샷을 자체적으로 검토된 시작 프레임 및 비디오 작업으로 처리하세요. 해당 프레임을 검토되지 않은 편집을 연결하는 대신 동일한 승인된 아이덴티티 참조에서 파생하세요. 결과물을 보존하는 모션을 선택하세요: 돌리는 카메라는 주제의 크기와 사용 가능한 카피 공간을 변경하는 반면, 고정된 카메라와 제한된 조명 또는 환경 모션은 히어로 레이아웃을 보존할 수 있습니다.

먼저 시작 프레임 구축

다음 중 하나의 경로를 선택하세요:

  1. 사용 가능한 소스 이미지가 이미 있는 경우: 구성, 의상, 배경, 조명, 제품 배치 또는 정리가 변경되어야 할 때 ai_image_editor_create_image를 호출하세요. 요청된 편집과 변경되지 않아야 할 모든 것을 명시하세요.
  2. 소스 이미지가 없는 경우: ai_image_generator_create_image를 호출하세요. AI 이미지 편집기는 입력 이미지가 필요합니다. 프롬프트만으로 생성 요청을 보내지 마세요.
  3. 제공된 이미지가 이미 샷을 만족하는 경우: 이미지 생성을 건너뛰고 직접 애니메이션하세요.

의도된 비디오 종횡비로 하나의 스틸을 생성하세요. 정확한 아이덴티티, 제품 지오메트리, 패키지 또는 브랜딩이 중요한 경우 승인된 참조를 사용하세요. 이미지-투-비디오가 잘못된 소스 프레임을 복구할 것이라고 기대하지 마세요.

wait_for_image_project로 이미지 프로젝트를 기다리세요. 완성된 스틸을 미리 보고, 잘못된 자르기, 해부학 문제, 변경된 아이덴티티, 변형된 제품, 부정확한 로고 또는 텍스트, 의도하지 않은 글자, 시각적 아티팩트 또는 누락된 네거티브 공간이 있는 경우 애니메이션 전에 거부하세요. 가장 작고 유용한 편집으로 스틸을 수정하세요. 두 번째 유료 이미지 요청은 승인된 예산이 필요합니다.

승인된 프레임 애니메이션

정확히 승인된 이미지 출력을 image_to_video_create_video에 전달하세요. 결과가 로컬 파일인 경우, 먼저 references/setup.md의 흐름을 사용하여 원시 바이트를 업로드하세요. 로컬 경로는 호스팅된 file_path가 아닙니다.

시간에 따른 변화를 중심으로 모션 프롬프트를 작성하세요:

  • 주제 동작, 명확한 속도 및 방향 포함
  • 카메라 움직임, 또는 카메라가 고정되어 있음을 명시적으로 명시
  • 직물, 증기, 머리카락, 빛 또는 입자와 같은 환경 모션
  • 고정되는 것
  • 타이밍 및 종료 상태, 페이드가 필요하지 않은 경우 유지되는 최종 노출 포함

새로운 시각적 언어로 전체 스틸을 다시 설명하지 마세요. 그렇게 하면 모델이 주제를 재설계하게 됩니다. 반응 샷의 경우: "물고기가 그녀의 어깨 옆으로 천천히 헤엄칩니다. 그녀가 그것을 알아차리고 놀란 미소를 지으며 약간 돌아섭니다. 느린 푸시 인(Push-In)이 그녀의 얼굴과 물고기를 분리합니다. 아이덴티티, 옷, 장면을 보존하세요. 컷 없음." 제품 레이아웃은 대신 고정된 주제와 보호된 카피 영역이 필요할 수 있습니다. 승인된 프레임이 주제를 오른쪽에 배치할 때 중앙에 배치하도록 요구하지 마세요.

현재 스키마가 선택된 모델, 해상도 및 지속 시간이 지원한다고 말하는 경우에만 엔드 프레임을 사용하세요. 일반 요청에는 라이브 권장 모델을 선호하세요. 필요한 제어를 스키마가 설명하는 경우에만 특수 모델을 선택하세요. 해상도와 지속 시간을 요청된 결과물에 맞추세요. 짧은 미리보기는 짧은 간격을 테스트하며, 더 긴 클립에 대한 안정성을 테스트하지 않습니다. 총 스틸+비디오 비용을 기존 승인과 비교하고, 의도된 작업을 커버하지 못하는 경우에만 요청하세요.

비디오를 한 번 제출하고, 프로젝트 ID를 보관하며, wait_for_video_project를 호출하세요. 대기 시간 초과는 생성 실패가 아니며, 생성 호출을 다시 제출하는 이유가 되지 않습니다.

검사 및 전달

프로젝트가 complete를 보고한 후, 반환된 다운로드 URL을 정확히 그대로 사용하세요. 다운로드된 치수, 지속 시간 및 오디오 존재를 확인하세요. 재생이 가능할 때 전체 클립을 시청한 다음, 첫 번째 프레임, 중간 지점, 마지막 프레임 및 의심스러운 전환을 검사하세요. 세 개의 정지 프레임만으로 깜빡임이 없음을 증명할 수 없습니다. 다음을 확인하세요:

  • 첫 번째 프레임이 승인된 스틸과 일치하는지
  • 아이덴티티, 제품 모양, 로고, 텍스트 및 의복이 안정적으로 유지되는지
  • 모션이 요청된 방향과 속도를 따르는지
  • 카메라가 표류하거나 예기치 않게 컷되지 않는지; 블랙 프레임 진단이 깨끗하더라도 실제 최종 프레임에서 원치 않는 페이드 또는 사라진 주제가 있는지 검사
  • 워핑, 깜빡임, 녹음, 중복 객체 또는 갑작스러운 최종 프레임 붕괴가 나타나지 않는지
  • 생성된 오디오가 의도적이고 일관성 있는지

하나의 필수 기준이 실패하면, 이를 식별하고 가장 작은 관련 입력을 변경하세요: 외관 문제는 시작 프레임, 움직임 문제는 모션 프롬프트, 또는 라이브 스키마가 필요한 동작을 지원하는 경우에만 모델/해상도를 변경하세요. 사용자 예산 외에 다른 시도에 크레딧을 사용하지 마세요.

portrait-to-koi 예제에서 아이덴티티는 인식 가능했지만 요청된 약간의 회전이 양방향으로 더 큰 회전이 되었습니다. 해당 모션을 수정할 때 승인된 스틸을 유지하세요. 다운로드된 캔버스가 요청된 비율과 약간 다른 경우, 로컬 자르기 전에 전체 액션 경로를 검사하세요. 그렇지 않으면 허용된 테이크를 가장자리 픽셀만 제거하기 위해 다시 생성하지 마세요.

완성된 비디오 또는 사용 가능한 링크, 해당되는 경우 저장된 위치, 이미지 및 비디오 프로젝트 ID, 그리고 모든 중요한 제한 사항을 반환하세요.

관련 스킬