API로 제품과 배경을 넣은 AI 아바타 영상 만들기

Sume Avatar 1.0 말하는 영상에 제품과 배경을 넣으려면 POST /v1/avatar-1.0/talking-video에 product_image(공개 HTTPS 이미지 URL)와 scene(텍스트 프롬프트 또는 사진 URL)을 추가하세요. 두 필드 모두 선택 사항입니다. 전체 렌더 비용을 내기 전에 결과가 어떻게 나오는지 보려면, 같은 필드로 아바타 영상 프리뷰를 먼저 만드세요.

필드 규칙은 2026-09-26에 확인한 Sume의 아바타 영상 생성, 미디어 입력, 아바타 영상 프리뷰 문서와 API 레퍼런스를 따릅니다. 기본적인 스크립트 요청은 말하는 아바타 영상 API에 있습니다.

제품과 배경은 어떤 필드로 넣나요?

스크립트 하나로 만드는 영상은 product_image와 scene 하나를 받습니다. 다중 장면 video_inputs 계획에서는 장면마다 background를 줄 수도 있지만, 현재 실행은 모든 장면 배경이 하나의 공유 장면으로 해석되기를 기대합니다.

제품 요청은 어떤 형태인가요?

아래 요청은 문서 예시를 따르되, handle은 자리 표시용 값으로 바꾸고 스크립트는 새로 썼습니다.

curl -X POST https://api.sume.com/v1/avatar-1.0/talking-video \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: avatar-product-001" \
  -d '{
    "avatar_handle": "product_host",
    "script": "Meet the Acme travel mug, now in three colors.",
    "product_image": "https://example.com/product.png",
    "scene": { "type": "prompt", "prompt": "Bright studio with clean product table" },
    "quality": "plus",
    "aspect_ratio": "9:16"
  }'

아바타가 제품을 손에 들고 나오나요?

문서에는 나와 있지 않습니다. 문서는 product_image를 선택 사항인 제품·레퍼런스 이미지라고만 설명하며, 제품이 화면의 어디에 어떻게 나오는지는 언급하지 않습니다. 여러분의 제품이 어떻게 나오는지 확인하는 방법은 전체 렌더가 과금되기 전에 프리뷰에서 첫 프레임을 보는 것입니다.

어떤 이미지 URL을 받나요?

미디어 필드는 가져올 수 있는 공개 HTTPS URL이어야 하며, 별도의 Sume 에셋을 먼저 만들 필요는 없습니다. 다음은 생성이 제출되기 전에 거부됩니다.

• localhost와 사설 네트워크 URL.
• HTTPS가 아닌 URL, 그리고 서명되었거나 비공개인 URL.
• product_image나 scene.image_url에 이미지가 아닌 응답이 오는 경우처럼, 콘텐츠 타입이 맞지 않는 응답.

비용을 내기 전에 제품과 배경을 어떻게 확인하나요?

POST /v1/avatar-video-previews로 프리뷰를 만드세요. 본문은 product_image와 scene을 포함해 Avatar Video 필드와 같습니다. 준비되면 preview_image_url이 대표 스틸이고, 가능한 경우 scene_previews[]에 입력 장면마다 스틸이 하나씩 담깁니다. 전체 흐름은 아바타 영상 프리뷰: 첫 프레임 승인하기에서 다룹니다.

• POST /v1/avatar-video-previews/:id/regenerate는 저장된 요청을 재사용해 첫 프레임 스틸만 새로 만듭니다.
• POST /v1/avatar-video-previews/:id/generate-video는 승인한 프리뷰에서 렌더를 시작하며 quality 덮어쓰기만 받습니다. 그래서 product_image나 scene을 바꾸려면 새 프리뷰가 필요합니다.

제품을 넣으면 가격은 얼마나 달라지나요?

제품 이미지를 넣으면 영상은 해당 등급의 "with product"(제품 포함) 요율로 바뀌며, 각 요율에는 기본적으로 5.5% 에이전트 수수료가 더해집니다.