짧은 클립을 반복(루프)해 영상 길이 늘리는 방법

클립을 반복(루프)해 영상 길이를 늘리려면, 노래나 보이스오버 길이처럼 필요한 시간을 채울 때까지 같은 클립을 연달아 반복하고 결과를 새 파일로 저장하세요. Sume에서는 클립이 이미 Sume에 호스팅되어 있다면, 오디오와 길이가 같은 Timeline 1.0 슬롯 하나에 클립을 넣으면 됩니다. 슬롯이 클립보다 길면 나머지는 render.pad_mode가 채우며, loop는 슬롯이 다 찰 때까지 클립을 다시 재생합니다.

아래 내용은 2026-09-27에 확인한 Timeline 1.0 문서와 Sume API 레퍼런스의 필드 설명을 기준으로 합니다. 현재 동작이라고 설명한 내용은 Sume의 코드에서 확인한 것입니다.

클립을 오디오 길이만큼 루프하려면 어떻게 하나요?

길이는 오디오가 정합니다. 1에서 1,800 사이의 audio.duration_seconds가 출력 길이이고, audio.url은 노래나 보이스오버로, 앞서 실행한 Sume Job에서 나온 음악이나 음성 트랙을 쓸 수 있습니다. 클립에는 start: 0에서 시작하고 duration이 그 길이와 같은 슬롯 하나를 주고, render.pad_mode를 loop로 설정하세요.

• 모든 URL은 앞서 실행한 Sume Job의 출력처럼 이미 워크스페이스에 있는 media.sume.com 아티팩트나 에셋이어야 합니다. Sume에는 컴퓨터에 있는 파일을 올리는 공개 업로드 경로가 없습니다. 엔드포인트별로 받는 URL을 참고하세요.
• 기본 출력이 1080×1920이므로 output.width와 output.height를 클립 크기에 맞추세요.
• 루프된 소스는 실패가 아니라 warnings[]의 소프트 경고로 돌아옵니다(현재 코드에서는 segment_source_short_looped). 과금되지 않는 POST /v1/timeline-1.0/plan으로 본문을 먼저 검사할 수 있지만, 문서에 따르면 이 검사는 패딩이나 루프 경고를 예측하지 못합니다.
• 소리 없는 영상이라면 url 없이 audio.mode: "silence"를 보내세요. 이때도 길이는 duration_seconds가 정합니다.

curl -X POST https://api.sume.com/v1/timeline-1.0/render \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: loop-to-song-001" \
  -d '{
    "audio": { "url": "https://media.sume.com/artifacts/artf_demo/song.mp3", "duration_seconds": 95 },
    "output": { "width": 1920, "height": 1080 },
    "render": { "pad_mode": "loop" },
    "video": [
      { "source_url": "https://media.sume.com/artifacts/artf_demo/clip-6s.mp4", "start": 0, "duration": 95 }
    ]
  }'

짧은 클립은 기본적으로 루프되나요?

대체로 그렇습니다. 기본값인 auto는 긴 정지 화면을 두는 대신 짧은 소스를 루프합니다. 다만 현재 컴파일러에서 auto는 슬롯이 클립보다 0.25초 넘게 길 때만 루프하며, 0.5초보다 짧은 소스는 loop를 지정해도 루프하지 않습니다. 루프하면 화면이 깜빡이기 때문이며, 대신 마지막 프레임을 유지합니다. 반복이 필요하면 기본값에 기대지 말고 loop를 직접 지정하세요.

클립 자체의 소리도 루프되나요?

아니요, 현재 컴파일러에서 Timeline 렌더의 소리는 스파인과 선택 사항인 사운드트랙에서만 나오고 클립에서는 나오지 않습니다. 따라서 루프된 화면에는 여러분의 노래나 보이스오버가 흐르고, 클립 자체의 오디오는 빠집니다. 배경 음악을 반복하려면 soundtrack.loop를 쓰세요. 스파인이 끝날 때까지 음악을 반복합니다. 영상에 배경 음악 넣기를 참고하세요.

루프 이음새가 보이나요?

반복할 때마다 클립이 처음부터 다시 재생되므로, 이음새마다 클립의 마지막 프레임과 첫 프레임 사이에 있는 튐이 그대로 보입니다. 시작할 때와 같은 화면으로 끝나는 클립이라면 이음새가 드러나지 않습니다. 그런 클립을 생성하는 방법은 끊김 없이 루프되는 AI 영상 만들기에서 보여 줍니다.

영상을 늘리는 방법은 루프뿐인가요?

아니요, 반복 대신 새로운 장면을 더하려면 마지막 프레임으로 AI 클립 잇기처럼 마지막 프레임에서 다음 클립을 생성하세요. 그리고 재생할 때 영상이 반복되기만 하면 된다면, 그것은 새 파일이 아니라 플레이어 설정입니다. Timeline 렌더는 더 긴 파일을 새로 씁니다.

비용은 얼마이고, 한도는 어떻게 되나요?

렌더는 API 요금에 나온 출력 분당 $0.10 기준으로 ceil(audio.duration_seconds / 60)분을 예약하며, 기본적으로 5.5% 에이전트 수수료가 더해집니다. 따라서 95초짜리 노래는 2분을 예약합니다. 예약한 금액보다 더 청구되지는 않습니다.

• 출력은 1초에서 1,800초까지이므로, 렌더 한 번으로 클립을 최대 30분까지 루프할 수 있습니다.
• output.width와 output.height는 256에서 2160 사이의 짝수 정수입니다.