Image-to-Video 제품 로고 왜곡: 프레임 vs 레퍼런스

제품 로고가 사진과 똑같아야 한다면 팩샷을 frame_type: "first_frame"과 함께 frame_images에 담아 POST /v1/videos로 보내세요. 프레임 이미지는 클립의 첫 프레임을 지정하지만, input_references에 넣은 이미지는 정확한 프레임이 아니라 시각적 가이드입니다. 움직이는 동안 라벨을 그대로 유지하는 설정은 문서에 없으므로, 게시하기 전에 완성된 클립에서 스틸을 추출해 팩샷과 비교하세요.

필드 동작은 2026-09-27에 확인한 Sume 문서 영상 생성 (영문), 영상 프레임, Image API (영문) 페이지를 따릅니다. 각 필드는 Image-to-Video API와 Reference-to-Video API에서 하나씩 다룹니다. 이 글은 제품을 알아볼 수 있게 유지해야 할 때 둘 중 무엇을 고를지를 다룹니다.

제품 사진은 첫 프레임으로 넣어야 하나요, 레퍼런스로 넣어야 하나요?

두 필드는 서로 다른 생성 모드를 시작하며, 클립의 프레임으로 지정되는 것은 프레임 이미지뿐입니다. 요청에 둘 다 있으면 frame_images가 우선하고, 요청은 이미지로 영상 만들기로 처리됩니다.

클립의 처음과 끝 모두에 제품을 고정할 수 있나요?

끝 프레임을 받는 모델이라면 가능합니다. 라벨 클로즈업 같은 이미지를 frame_type: "last_frame"인 두 번째 frame_images 항목으로 추가하면, 클립이 여러분의 이미지로 시작하고 끝납니다. 먼저 GET /v1/videos/models에서 supported_frame_images를 확인하세요. 문서의 Seedance 2.0 항목에는 first_frame과 last_frame이 모두 나와 있습니다. 그 사이의 프레임은 생성됩니다.

팩샷은 어떻게 준비해야 하나요?

움직임을 주기 전에 스틸부터 확정하세요.

• 공개 HTTPS URL에 호스팅하세요. 영상 문서는 레퍼런스 이미지가 공개 HTTPS로 접근할 수 있고 지원되는 형식이어야 한다고 안내합니다.
• 먼저 POST /v1/images에서 편집한다면, 레퍼런스에 맞추도록 aspect_ratio: "auto"를 보내세요. 단, 카탈로그에 auto가 나와 있는 모델이어야 합니다. 필드를 생략하는 것은 auto와 같지 않습니다.
• 편집할 때 ChatGPT Image 2.5(openai/gpt-image-2.5)는 선택 사항인 공개 HTTPS mask_url도 받습니다.
• POST /v1/images가 반환하는 data[].url은 Sume에 호스팅된 서명된 URL이며, 영상 문서에는 이 URL을 frame_images에 바로 넘기는 방법이 나와 있지 않습니다. 고른 스틸은 직접 관리하는 공개 HTTPS URL에 호스팅하세요.

완성된 클립에서 로고는 어떻게 확인하나요?

중요한 순간의 스틸을 추출해 팩샷과 비교하세요. POST /v1/video-frames는 워크스페이스에 있는 media.sume.com 클립 하나와 함께 at[](타임스탬프 1–24개, 각각 0 이상이고 클립 길이 미만) 또는 fps(0 초과 2 이하, 최대 24프레임) 중 정확히 하나를 받습니다. 소스 프레임 크기를 유지하려면 max_edge를 빼고, 무손실로 검사하려면 png를 요청하세요.

/v1/videos 폴링은 API 호스트의 unsigned_urls를 반환합니다. 같은 Job은 GET /v1/jobs/{id}/result에서도 볼 수 있고, 완료된 Job에는 media.sume.com 아래의 공개 아티팩트가 포함될 수 있습니다. 추출은 과금되지 않으며 제출 응답은 항상 202입니다. resource_status가 ready가 될 때까지 GET /v1/video-frames/{id}를 폴링한 뒤 frames[]를 읽으세요.

curl -X POST https://api.sume.com/v1/video-frames \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: label-check-001" \
  -d '{
    "video_url": "https://media.sume.com/artifacts/artf_demo/clip.mp4",
    "at": [0, 2, 4, 6, 8],
    "format": "png"
  }'

제품 이미지를 받는 다른 Sume 경로는 무엇인가요?

두 가지가 더 있으며, 경로마다 제약이 따로 있습니다.

• 제품을 소개하며 말하는 진행자: Avatar 1.0은 POST /v1/avatar-1.0/talking-video에서 선택 사항인 product_image를 받습니다. 문서는 제품이 화면의 어디에 나오는지 밝히지 않으므로, API로 제품과 배경을 넣은 AI 아바타 영상 만들기에서처럼 먼저 프리뷰를 검토하세요.
• 설명에 패키지를 명시한 카탈로그 이미지 Format: 예를 들어 sume-serum-drip(“accurate bottle packaging”, 정확한 병 패키지)과 sume-sunscreen-splash(“accurate SPF packaging”, 정확한 SPF 패키지)가 있습니다. 이는 각 Format이 명시한 목표일 뿐 보장이 아닙니다. Format 미디어는 내구성 있는 공개 media.sume.com URL로 돌아오므로, 승인한 스틸을 첫 프레임으로 쓸 수 있습니다.

어떤 제한이 있나요?

문서가 정한 한계는 다음과 같습니다.

• 움직임 속에서 로고나 라벨을 그대로 유지하는 설정은 문서에 없습니다. 프레임 이미지는 클립의 한쪽 끝을 지정하고, 레퍼런스는 가이드 역할만 합니다.
• last_frame은 supported_frame_images에 이 값을 나열한 모델에서만 동작합니다.
• 영상 프레임은 최대 300초 길이의 media.sume.com 클립을 읽고, 호출당 스틸을 최대 24장 반환합니다. [0, duration) 범위를 벗어난 타임스탬프는 frame_time_out_of_range로 실패합니다.