Shopify 제품 이미지 크기와 영상 규격: AI 미디어용

Shopify 도움말 센터는 제품 이미지를 최대 5000 x 5000 px(25메가픽셀), 20 MB 미만까지 허용하고, 정사각형 이미지는 보통 2048 x 2048 px가 가장 잘 표시된다고 안내합니다. 개발자 문서는 이미지 상한을 4472 x 4472 px(20 MP)로 둡니다. Sume API로 2048x2048 제품 이미지를 만들려면 openai/gpt-image-2.5 같은 ChatGPT Image 모델에 image_size: { "width": 2048, "height": 2048 }을 보내세요.

Shopify의 수치는 도움말 센터 페이지 제품 미디어 유형과 개발자 가이드 제품과 컬렉션의 미디어 관리에서 인용했으며, 둘 다 2026-09-27에 확인했습니다. Sume의 수치는 Image API (영문), Timeline 1.0, 영상 검사 문서와 Sume API 레퍼런스, Sume의 이미지 카탈로그 코드에서 가져왔습니다. Shopify Admin API로 파일을 첨부하는 방법은 products/create 웹훅으로 만드는 Shopify 제품 영상에서 다룹니다.

Shopify는 제품 미디어로 어떤 크기를 받나요?

Shopify의 공식 페이지 두 곳은 이미지 상한과 4K 영상 크기를 서로 다르게 제시하며, 더 엄격한 쪽은 개발자 문서의 수치입니다. 두 페이지 모두 2048 x 2048 px를 권장하고, 도움말 센터는 대표 이미지가 컬렉션 페이지에서 같은 크기로 표시되려면 화면 비율이 하나로 일정해야 한다고 덧붙입니다.

2048x2048 제품 이미지는 어떻게 생성하나요?

ChatGPT Image 모델을 지정하고 image_size에 픽셀을 넣으세요. 표에서 보듯 2048x2048은 이 모델의 커스텀 크기 규칙을 모두 통과합니다. Shopify가 대부분의 제품 이미지에 가장 좋다고 하는 형식인 output_format: "png"도 보내세요. 모델의 다른 필드는 Sume의 GPT Image 2.5 API에서 다룹니다.

응답의 data[].url은 Sume가 호스팅하는 서명된 URL이고, Sume 인증 문서는 서명된 다운로드 URL을 임시 시크릿으로 취급하라고 안내하므로 Shopify에 바로 넘기세요. Shopify의 fileCreate가 파일을 직접 내려받아 저장합니다. 생성이 오래 걸리면 이미지 본문 대신 폴링할 Job과 함께 202로 응답합니다.

curl -X POST https://api.sume.com/v1/images \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2.5",
    "prompt": "A ceramic mug on a plain light gray background, soft studio light",
    "image_size": { "width": 2048, "height": 2048 },
    "output_format": "png"
  }'

어떤 Sume 이미지 크기가 Shopify 한도 안에 들어가나요?

허용되는 모든 ChatGPT Image 커스텀 크기는 Shopify의 두 픽셀 한도 아래에 있습니다. 최대 변 길이 3840픽셀은 4472와 5000보다 작고, 최대 8,294,400픽셀은 20메가픽셀보다 작습니다. 대표 이미지의 형태를 똑같이 유지하려면 모든 호출에 같은 image_size를 보내세요. n은 호출당 최대 10장을 반환하며, 카탈로그에는 모델별로 더 낮은 상한이 있습니다.

다른 모델은 크기를 다르게 처리합니다. 예를 들어 Nano Banana는 픽셀 image_size를 그 픽셀대로 그리지 않고 네이티브 화면 비율 중 하나로 매핑합니다. 모델별 규칙은 AI 이미지 화면 비율과 커스텀 크기에서 다룹니다. 어떤 모델이든 업로드하기 전에 각 파일이 Shopify의 20 MB 한도를 넘지 않는지 확인하세요.

어떤 Sume 영상이 Shopify 영상 한도에 맞나요?

스트리밍을 지원하는 브라우저에서 Shopify는 시청자의 연결 상태와 업로드한 영상의 해상도에 따라 제품 영상을 480p, 720p, 1080p로 재생합니다. 1920x1080이나 기본값인 1080x1920의 Timeline 1.0 렌더는 두 페이지의 4K 상한 안에 들며, Shopify가 받는 영상 형식 세 가지 중 하나인 MP4로 출력됩니다. Timeline은 Shopify의 10분을 넘는 최대 1800초까지 렌더링하므로, audio.duration_seconds를 600 이하로 유지하세요.

1080p의 seedance-2.5처럼 생성한 클립은 문서에 해상도 등급만 나와 있고 픽셀 크기는 나와 있지 않습니다. 과금되지 않는 POST /v1/video-inspect를 frames: false로 실행해 width, height, duration_seconds, size_bytes를 읽고, 업로드하기 전에 Shopify 상한과 비교하세요.

Shopify 제품 페이지용으로 Sume가 만들 수 없는 것은 무엇인가요?

현재 Shopify 제품 미디어 중 두 가지는 만들 수 없습니다.

• 3D 모델. Shopify의 3D 슬롯은 GLB나 USDZ 파일을 받는데, Sume의 생성 계열은 아바타, 이미지, 영상, 음악입니다.
• 조립한 4K 영상. Timeline과 영상 트림은 출력의 각 변을 2160픽셀로 제한하므로 3840x2160과 4096x2160에 못 미칩니다.