Communitygithub.com

제품 비디오

Makernice를 사용하여 제품 쇼케이스, 광고 클립, 마켓플레이스 등록용 비디오 등 짧은 제품 및 전자상거래 비디오를 계획하고 생성합니다. 모드 선택, 프롬프트 작성, 화면 비율 및 해상도 선택, 가격 확인, 작업 실행을 다룹니다.

제품 비디오란 무엇인가요?

이 스킬은 Makernice 플랫폼을 활용하여 제품 사진을 짧은 동영상 클립으로 변환하는 과정을 안내합니다. 사용자는 제품 설명, 제품 사진(공개 HTTPS 링크), 사용처(TikTok, Reels, 유튜브, 마켓플레이스 등)에 따라 적절한 화면 비율(9:16, 16:9, 1:1)을 제공해야 합니다. 스킬은 사용 가능한 모델과 모드(i2v, t2v, r2v)를 조회하고, 예산과 클립 길이(보통 5~10초)에 따라 최적의 옵션을 추천합니다. 프롬프트 작성 시 주제, 동작/카메라 움직임, 배경/조명, 스타일을 순서대로 포함하며, 가격 추정 후 사용자 승인을 받아 작업을 실행합니다. 작업 상태는 `check_job`으로 모니터링하며, 실패 시 재시도하고, 완료 시 결과 링크를 제공합니다. 다중 클립 비디오는 각 클립별로 별도 작업을 실행합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/makernice/makernice-plugin/tree/HEAD/skills/product-video

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

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

문서

제품 비디오은(는) 무엇을 하나요?

제품(가급적 사진 포함)을 짧은 비디오 클립으로 변환합니다. 사용자의 언어로 응답하세요. 모든 가격은 USD입니다.

1. 브리프 수집

누락된 항목만 물어보세요:

  • 제품: 무엇인지, 재질, 색상, 크기, 보여줄 한 가지 기능.
  • 제품 사진: 깨끗한 사진의 공개 https 링크. 로컬 파일과 비공개 링크는 작동하지 않습니다. 사용자가 먼저 공개 https URL에 이미지를 호스팅해야 합니다.
  • 사용처: 가로 세로 비율을 결정합니다.
    • TikTok, Reels, Shorts, 스토리: 9:16
    • 웹사이트 히어로, YouTube, 랜딩 페이지: 16:9
    • 마켓플레이스 리스팅, 피드 게시물: 1:1 (모델이 제공하는 경우)
  • 길이와 예산: 대부분의 클립은 5~10초입니다. 더 긴 비디오의 경우, 하나의 긴 클립 대신 여러 개의 짧은 클립을 계획하세요.

2. 모델 및 모드 선택

list_models를 호출한 다음, 후보 ID로 model을 설정하여 modes, aspect_ratios, durations, options 및 max_prompt_chars를 확인하려면 다시 호출하세요.

  • 사진 있음: 사진을 image_url로 사용하여 i2v 모드를 사용하세요. 실제 제품의 형태, 라벨 및 색상을 유지합니다.
  • 여러 참조 사진(다른 각도의 제품): 모델에 r2v 모드가 있는 경우, reference_images와 함께 사용하고 max_references를 초과하지 마세요.
  • 사진 없음: t2v 모드를 사용하고 제품을 정확하게 설명하세요.
  • 모델이 options에 negative_prompt를 나열하는 경우, "왜곡된 라벨, 여분의 부품, 흐릿함"과 같은 것에 사용할 수 있습니다.

3. 프롬프트 작성

하나의 클립, 하나의 샷. 다음 순서로 프롬프트를 구성하세요:

  1. 주제: 정확한 제품, 재질 및 색상 ("코르크 바닥이 있는 매트 블랙 세라믹 커피 머그").
  2. 동작 또는 카메라 이동: 한 가지 동작만, 예: 느린 푸시인, 부드러운 360도 궤도, 탑다운 공개, 텍스처를 가로지르는 매크로 팬, 손으로 집어 올리기.
  3. 설정 및 조명: 표면, 배경, 조명 ("밝은 오크 테이블 위, 부드러운 아침 창문 빛, 얕은 피사계 심도").
  4. 스타일 및 속도: "깨끗한 상업적 룩, 차분한 페이스".

팁:

  • 모델에 단어, 가격 또는 로고를 텍스트로 렌더링하도록 요청하지 마세요. 종종 깨져 나옵니다. 나중에 편집기에서 텍스트를 추가하세요.
  • i2v를 사용할 때는 제품의 외형을 다시 설명하지 말고 동작과 장면을 설명하세요. 사진이 이미 정의합니다.
  • max_prompt_chars를 초과하지 마세요.

예시:

밝은 오크 테이블 위에 코르크 바닥이 있는 매트 블랙 세라믹 커피 머그, 김이 피어오르고, 카메라가 천천히 푸시인하며, 부드러운 아침 창문 빛, 얕은 피사계 심도, 깨끗한 상업적 룩, 차분한 페이스.

4. 해상도 및 가격

  • 먼저 720p로 초안을 작성하여 움직임과 프레이밍을 확인하세요. 비용이 적게 듭니다. 웹사이트, 광고 또는 대형 화면용 최종본은 1080p로 만드세요. 720p는 종종 휴대폰 피드에 충분합니다.

  • 초안 및 최종 옵션에 대해 estimate_cost를 호출하고 실행 전에 사용자에게 두 가격을 모두 보여주세요:

    {"input": {"model": "<model id>", "mode": "i2v", "prompt": "A matte black ceramic coffee mug on a light oak table, steam rising, the camera slowly pushes in, soft morning light", "image_url": "https://example.com/mug.jpg", "duration": 5, "resolution": "720p", "aspect_ratio": "9:16"}}
    

5. 사용자 동의 후 생성

사용자가 가격을 확인하고 동의한 후에만 generate를 호출하세요. 사용자가 이미 예산을 설정하고 진행하라고 말한 경우, amount_usd가 해당 예산 내에 있는 한 다시 묻지 않고 시작할 수 있습니다. 그래도 amount_usd를 사용하고 예산을 max_cost_usd로 사용하지 마세요.

  • max_cost_usd: 필수. estimate_cost의 승인된 amount_usd를 반환된 그대로 사용하세요. 가격이 더 높으면 작업이 거부됩니다.
  • request_id: 모든 새 작업에 대해 필수 및 고유하며, 공백 없이 인쇄 가능한 ASCII 문자로 최대 64자입니다. 예: mug-orbit-720p-1. 사용된 ID는 다른 작업에 재사용할 수 없습니다.
  • generate가 네트워크 오류, 시간 초과, 시스템 오류 또는 "Too many requests"로 실패하면, 몇 초 기다렸다가 동일한 input, 동일한 max_cost_usd 및 동일한 request_id로 다시 시도하세요. 동일한 ID는 동일한 작업을 반환하며 두 번 청구되지 않습니다.
{"input": {"model": "<model id>", "mode": "i2v", "prompt": "A matte black ceramic coffee mug on a light oak table, steam rising, the camera slowly pushes in, soft morning light", "image_url": "https://example.com/mug.jpg", "duration": 5, "resolution": "720p", "aspect_ratio": "9:16"}, "max_cost_usd": "<amount_usd from estimate_cost>", "request_id": "mug-orbit-720p-1"}

check_job을 사용하여 job_id와 wait_s를 55로 설정하고 기다리세요. 작업이 여전히 실행 중이면 next_step을 따르고 wait_s를 55로 다시 호출하세요. 빡빡한 루프로 폴링하지 마세요.

성공하면 outputs의 결과 링크와 console_url을 제공하세요. 링크는 24시간 후에 만료됩니다. check_job은 새 링크를 반환합니다. 출력에 url 없이 state가 blocked인 경우, 안전 검토가 생성 후 결과를 숨긴 것입니다. 해당 작업은 여전히 청구되며, 사용자는 Makernice에 연락하여 검토를 요청할 수 있습니다. 실패한 작업은 청구되지 않습니다. error의 이유를 사용자에게 알리세요.

여러 클립 비디오의 경우, 각 클립마다 자체 estimate_cost, max_cost_usd 및 새 request_id로 하나의 작업을 실행하고 사용자에게 누계를 제공하세요.

거부 처리

  • max_cost_usd를 초과하는 가격: 새 가격을 표시하고 새 max_cost_usd와 새 request_id로 재시도하기 전에 물어보세요.
  • 작업당 한도 초과: 720p 또는 더 짧은 지속 시간을 제안하거나, 사용자가 Makernice에서 작업당 한도를 높일 수 있습니다.
  • 잔액 부족 또는 일일 한도 도달: get_balance를 호출하고 설명하세요. get_topup_link 도구를 사용할 수 있고 사용자가 잔액을 추가하는 방법을 묻는 경우, 링크를 한 번 제공하세요.
  • 대기 중인 작업의 잘못된 설정: cancel_job을 job_id와 함께 호출하면 보류된 금액이 전액 해제됩니다.

관련 스킬