api/looping-video

이미지 한 장을 미세하고 실제 같은 움직임이 담긴 끊김 없는 루프 영상으로 바꿉니다 — 눈에 띄는 루프 이음새도, 카메라 움직임도 없이 살아 움직이는 사진처럼.

가격

480p에서는 초당 8크레딧($0.08), 768p에서는 초당 16크레딧($0.16)입니다.

문서 및 코드 샘플

신뢰받는

개요

Looping Video API는 정지 이미지 한 장을 5~15초 길이의 끊김 없는 루프 MP4 영상으로 바꿔 줍니다. 흩날리는 천, 흔들리는 머리카락, 피어오르는 김, 은은한 반사광처럼 미세하고 실제 같은 움직임이 사진에 생기를 불어넣고, 영상은 눈에 띄는 튐이나 끊김 없이 끝없이 반복 재생됩니다.

실제 예시 보기

이 페이지의 모든 영상은 정지 이미지 한 장에서 API 호출 한 번으로 생성했습니다. 별도 촬영본도, 재촬영도, 편집도 없습니다.

움직이는 제품 페이지

잎이 흔들리고, 미스트가 퍼지고, 물방울에 빛이 반짝입니다 — 그동안 용기와 라벨, 구도는 촬영한 그대로 유지됩니다. 카탈로그의 모든 대표 이미지를 살아 있는 제품 미디어로 바꿔 보세요.

매출로 이어지는 분위기

김이 피어오르고, 햇빛이 반짝이고, 먼지가 빛줄기를 가로질러 떠다닙니다. 은은한 움직임은 메뉴판과 매장 페이지, 캠페인 페이지에 정지 이미지로는 낼 수 없는 현장감을 더합니다.

주요 기능

끊김 없는 루프

영상은 반복 재생을 전제로 만들어집니다. 끝에서 처음으로 넘어갈 때 눈에 띄는 튐이나 끊김, 어긋남이 없어 제품 페이지와 디스플레이, 소셜 피드에서 클립을 끝없이 재생할 수 있습니다.

미세하고 자연스러운 움직임

실제로 움직일 법한 요소에만 움직임이 적용됩니다. 산들바람에 흔들리는 옷과 머리카락, 나뭇잎의 일렁임, 잔잔한 호흡, 흔들리는 반사광, 피어오르는 김, 공기 중을 떠다니는 입자가 그 대상입니다. 인물의 얼굴과 생김새, 제품 형태, 텍스트, 로고, 구도, 조명은 그대로 보존됩니다.

고정 카메라

모든 영상은 고정된 카메라를 사용합니다. 팬, 줌, 틸트, 롤, 리프레이밍은 — 요청하더라도 — 적용되지 않으므로, 결과물은 살아 움직이는 사진처럼 보입니다.

선택적 연출 지시

"옷이 바람에 살짝 날리는 모습"처럼 짧은 프롬프트로 움직임을 연출할 수 있습니다. 루프를 깨뜨리거나 카메라를 움직이는 지시는 자동으로 무시됩니다.

입력값과 기본값

요청 한 건에는 이미지 소스를 정확히 하나만 넣습니다.

image 파일(멀티파트 업로드)
base64 또는 데이터 URL 형식의 image(JSON)
원격 image_url

선택 파라미터:

prompt: 움직임에 대한 연출 지시. 예를 들어 "옷이 바람에 살짝 날리는 모습".
duration: 5에서 15 사이의 정수 초. 기본값은 5입니다.
resolution: 480p 또는 768p. 기본값은 768p입니다.
include_audio: 기본값은 true입니다. false로 설정하면 생성된 MP4에 오디오 트랙이 들어가지 않습니다.

가격

가격은 생성된 영상의 초 단위로 책정됩니다.

480p: 초당 8크레딧($0.08) — 5초에 40크레딧, 15초에 120크레딧
768p: 초당 16크레딧($0.16) — 5초에 80크레딧, 15초에 240크레딧

오디오 포함 여부는 가격을 바꾸지 않습니다. 크레딧은 작업이 접수된 경우에만 차감되며, 환불 대상 실패는 자동으로 환불됩니다.

활용 사례

이커머스 및 제품 페이지

은은한 움직임으로 제품 사진에 생동감 더하기
승인된 제품 컷으로 루프 대표 미디어 만들기
카탈로그 전반에 움직임 변형을 일괄 생성하기

패션 및 의류

룩북과 캠페인 이미지에 옷감과 머리카락의 미세한 움직임 더하기
모델 포즈와 의상 핏, 스타일링은 원본 사진 그대로 유지하기

마케팅 및 소셜 미디어

정적 크리에이티브를 시선을 붙잡는 루프 영상 광고로 전환하기
디스플레이와 랜딩 페이지에 쓸 무한 반복 배경 만들기
영상 촬영 없이 가벼운 모션 콘텐츠 제작하기

개인정보 보호 및 보안

모든 요청은 전송 중 암호화됩니다
업로드한 이미지는 처리 목적으로만 임시 저장됩니다
생성된 영상은 CDN URL로 전달되어 내려받을 수 있습니다
고객의 이미지와 영상은 모델 학습에 사용되지 않습니다

시작하기

요청 한 번으로 작업을 제출합니다. API는 202 Accepted와 작업 ID를 반환합니다:

curl -L 'https://api.developer.pixelcut.ai/v1/video/loop' \
-H 'Content-Type: application/json' \
-H 'X-API-KEY: <API_KEY>' \
-d '{
  "image_url": "https://cdn3.pixelcut.app/product.jpg",
  "prompt": "clothes blowing subtly in the wind, person slightly moving",
  "duration": 5,
  "resolution": "768p",
  "include_audio": true
}'

Location 헤더에 담긴 작업 상태 엔드포인트를 작업이 끝날 때까지 폴링한 다음, result_url에서 MP4를 내려받습니다:

curl -L 'https://api.developer.pixelcut.ai/v1/video/loop/job/<JOB_ID>' \
-H 'X-API-KEY: <API_KEY>'

작업이 pending 또는 running 상태인 동안에는 계속 폴링합니다. 상태가 completed가 되면 응답에 루프 MP4의 result_url이 포함되고, failed이면 표준 오류 code와 message가 포함되며 환불 대상 실패는 자동으로 환불됩니다.