Shopify 제품 사진을 영상으로 자동 변환하는 방법

Shopify 제품 사진은 세 가지 방법으로 제품 영상으로 자동 변환할 수 있습니다. Shopify App Store에서 AI 영상 앱을 설치하거나, 제품 링크를 URL 영상 변환 광고 도구에 보내거나, Shopify 트리거가 제품 사진을 하나씩 이미지로 영상 만들기 API에 보내고 여러분의 앱이 완성된 MP4를 제품에 다시 첨부하는 작은 파이프라인을 만드는 것입니다. 어느 쪽이 맞는지는 영상을 어디에 쓰는지(제품 페이지 갤러리 또는 소셜 광고), 제품이 몇 개인지, 모델과 프롬프트와 검토를 얼마나 직접 제어하고 싶은지에 달려 있습니다.

아래 Shopify 관련 사실은 Shopify 도움말 센터와 shopify.dev에서, 다른 공급사 관련 사실은 각 공급사 페이지에서 가져왔으며, 모두 2026-09-29에 확인했습니다. Sume 관련 사실은 영상 생성 (영문)과 웹훅 (영문) 문서에서 가져왔습니다. Sume는 API 옵션 중 하나입니다. Shopify 앱이 없으므로 Sume를 쓰면 파이프라인을 직접 작성합니다.

어떤 방법으로 자동화해야 하나요?

옵션마다 비용을 내는 방식, 실행되는 모델, 직접 작성할 코드의 양이 다릅니다.

내 스토어에는 어떤 옵션이 맞나요?

영상을 어디에 쓰는지, 파이프라인을 얼마나 직접 맡고 싶은지에 따라 고르세요.

• 코드를 작성하지 않고 Shopify 관리자 화면 안에서 해결하고 싶다면 Shopify App Store 앱을 고르세요. 각 앱 페이지에서 사진으로 무엇을 만드는지, 제품 미디어로 게시하는지 확인하세요.
• 제품 페이지 링크나 제품 이미지 한 장으로 만든 소셜 광고가 필요하고, 월 API 요금제에서 영상 30초당 크레딧으로 과금되는 방식이 괜찮다면 Creatify를 고르세요.
• 해당 공급사의 자체 모델만 필요하다면 Runway나 Kling의 API를 고르세요. Runway 요금 페이지에는 veo3.1도 있지만, Google의 Veo는 Sume 카탈로그에 없습니다.
• 위의 영상 모델 ID 11개를 API 키 하나와 잔액 하나로 쓰고, 서명된 완료 웹훅과 멱등 재시도가 필요하며, 작은 서버를 운영할 수 있다면 Sume를 고르세요. 클립 하나가 아니라 편집을 마친 완성 광고가 필요하다면 모든 사진을 attachments로 카탈로그 Format 실행에 보내세요. 목록은 바로 쓰는 제품 영상 Format: Sume Format 카탈로그에 있습니다.
• Shopify 안에서 쓰는 노코드 앱, 제품 미디어로 한 번에 게시하는 기능, 제품 페이지 URL을 읽는 도구가 필요하다면 Sume는 맞지 않습니다. POST /v1/videos는 이미지 URL을 받습니다.

직접 만드는 파이프라인은 단계별로 어떻게 작동하나요?

서버는 제품마다 다섯 가지 일을 하며, HTTPS로 Shopify의 Admin API와 Sume의 API를 호출합니다. Sume 호출만 따로 다룬 글은 제품 사진 영상 변환 API: SKU 사진으로 만드는 이커머스 클립입니다.

• 1. product 쿼리와 그 media 연결로 제품 사진을 읽습니다.
• 2. 사진 URL 하나를 frame_images에 first_frame으로 넣고 callback_url과 함께 POST /v1/videos로 보냅니다.
• 3. Sume의 서명된 job.completed 웹훅을 기다리거나 Job을 폴링합니다.
• 4. stagedUploadsCreate와 fileCreate로 MP4를 Shopify에 업로드하고, READY가 될 때까지 기다린 뒤 파일을 제품에 연결합니다.
• 5. Shopify가 products/create를 보낼 때마다, 또는 Shopify Flow 워크플로가 서버를 호출할 때 큐에서 1–4단계를 실행합니다.

Admin API로 제품 사진을 어떻게 읽나요?

ID로 제품을 쿼리하고 media 연결을 읽으세요. 이 연결에 유효한 미디어는 이미지, 3D 모델, 영상입니다. 각 이미지 노드는 MediaImage이며, 그 image.url이 사진입니다. Shopify 미디어 가이드는 read_products, write_products, write_files 액세스 스코프를 전제로 하며, 이 스코프로 4단계도 처리할 수 있습니다.

제품에 아직 사진이 없을 수 있습니다. Shopify의 샘플 products/create 페이로드는 images 배열이 비어 있으므로, 이미지 노드가 없는 제품은 건너뛰거나 다시 시도하세요.

query ProductPhotos($id: ID!) {
  product(id: $id) {
    title
    media(first: 10) {
      nodes {
        ... on MediaImage {
          image { url }
        }
      }
    }
  }
}

사진을 Sume에 보내고 영상을 기다리려면 어떻게 하나요?

사진 URL을 frame_type: "first_frame"과 함께 frame_images에 넣으세요. 그러면 요청이 이미지로 영상 만들기가 되어, 클립이 실제 제품 사진에서 시작합니다. 모델 ID는 각 모델의 해상도, 화면 비율, 길이, supported_frame_images를 나열하는 GET /v1/videos/models에서 고르세요. 모델이 지원한다면 세로 소셜 클립에는 9:16을, 정사각형 갤러리 클립에는 1:1을 쓰세요. 재시도할 때 두 번째 Job 대신 원래 Job이 반환되도록 Idempotency-Key를 보내고, 이 키는 제품 ID로 만드세요.

callback_url을 설정하면 Job이 종료 상태에 이를 때 Sume가 한 번 POST합니다. job.completed는 media.sume.com에 있는 파일을 payload.artifacts[].url에 담아 보내고, job.failed와 job.canceled는 status: "ERROR"로 도착합니다. x-sume-webhook-signature 헤더를 검증하고, 일치하는 sume-v1= 항목이 하나라도 있으면 수락하세요. 웹훅이 없다면 completed가 될 때까지 GET /v1/videos/{jobId}를 폴링한 뒤, API 키로 GET /v1/videos/{jobId}/content에서 내려받으세요.

curl -sS -X POST https://api.sume.com/v1/videos \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: shopify-product-123-v1" \
  -d '{
    "model": "seedance-2",
    "prompt": "Slow turntable shot of the product on a plain studio background",
    "frame_images": [
      {
        "type": "image_url",
        "image_url": { "url": "https://example.com/product.jpg" },
        "frame_type": "first_frame"
      }
    ],
    "aspect_ratio": "9:16",
    "resolution": "720p",
    "duration": 5,
    "callback_url": "https://app.example.com/hooks/sume"
  }'

영상을 제품에 다시 첨부하려면 어떻게 하나요?

먼저 MP4를 내려받으세요. Shopify의 `FileCreateInput`은 이미지, 일반 파일, 외부 영상에만 외부 URL을 받으며, 영상에는 staged upload URL이 필요합니다. Shopify의 업로드 단계는 필수 값인 fileSize를 넣은 stagedUploadsCreate, MP4의 multipart POST, resourceUrl을 originalSource로 넣은 fileCreate, READY(또는 FAILED)가 될 때까지의 fileStatus 폴링, 그리고 originalSource에 파일 ID를 넣어 파일을 참조하는 productSet, productCreate, productUpdate 중 하나입니다. 전체 뮤테이션은 Shopify 제품 영상 AI API: products/create 웹훅에 나와 있습니다.

새 제품마다 자동으로 실행하려면 어떻게 하나요?

웹훅을 쓴다면 products/create를 구독하고, 제품 ID를 큐에 넣은 뒤, Shopify의 오 초 제한 안에 응답하세요. 1–4단계는 큐에서 실행합니다.

직접 만든 웹훅 수신기가 없다면, 트리거와 조건과 액션으로 이루어진 워크플로를 실행하는 무료 앱 Shopify Flow로 파이프라인을 시작할 수 있습니다. Flow의 Send HTTP request 액션은 Shopify Plus, Advanced, Grow 요금제에서만 쓸 수 있습니다. Flow는 응답을 최대 30초까지 기다리고 오류가 나면 최대 24시간 동안 재시도할 수 있으므로, 재시도가 두 번째 영상을 만들지 않도록 Sume Idempotency-Key를 제품 ID로 만드세요. API 키는 실행 로그에서 값이 가려지는 Flow의 Secrets에 보관하세요. Sume의 인증 문서도 키를 서버 쪽에 두도록 안내합니다.

영상을 검토 없이 게시해도 되나요?

이미지로 영상 만들기 모델은 사진에 없는 움직임을 더하므로, 생성된 프레임이 실제 제품과 색, 글자, 모양에서 다를 수 있습니다. 한 가지 안전장치는 생성은 자동으로 하되, 사람이 승인한 뒤에 게시하는 것입니다.

• 제품 태그나 상태로 생성 여부를 정해, 최종 사진이 없는 제품은 건너뛰세요.
• 결과를 각각 초안으로 저장하고, 4단계에서 첨부하기 전에 검토자에게 링크를 보내세요.
• 색, 로고, 라벨 문구, 변형(variant)을 사진과 비교하고, 다른 클립은 다시 생성하거나 버리세요.
• 실제 사진은 갤러리에 그대로 두세요. 영상은 사진에 더해지는 것입니다.

Shopify는 제품 영상에 어떤 한도를 두나요?

제품 페이지에 영상을 표시하려면 스토어에 Shopify가 만든 Online Store 2.0 테마 같은 영상을 지원하는 테마가 필요하며, 그렇지 않다면 테마를 수정해야 합니다. 제품 하나에는 이미지, 3D 모델, 영상을 최대 250개까지 담을 수 있고, 이 한도는 늘릴 수 없습니다. Shopify의 공식 페이지 두 곳은 4K 크기를 서로 다르게 제시합니다.

이 자동화로 할 수 없는 것은 무엇인가요?

Shopify에서 오는 제한도 있고 Sume에서 오는 제한도 있습니다.

• 사진이 없는 제품은 아직 움직일 대상이 없습니다.
• POST /v1/video-inspect(과금되지 않는 검사)와 Timeline 1.0 같은 Sume의 미디어 도구는 media.sume.com 파일만 읽으므로, 생성한 클립은 Shopify로 옮기기 전에 확인하거나 편집하세요.
• Timeline 1.0 렌더는 최대 1800초까지 실행되어 Shopify의 10분을 넘고, 각 변을 2160픽셀로 제한하므로 두 4K 크기 모두에 못 미칩니다.
• 3D 모델. Shopify의 3D 슬롯은 GLB나 USDZ 파일을 받는데, Sume의 생성 계열은 아바타, 이미지, 영상, 음악입니다.
• 제품 사진 자체. 스틸 이미지 크기는 "Shopify 제품 이미지 크기" 글에 정리되어 있습니다.