HiAPI
블로그

사용 가이드

Seedance 2.5 Flash 이미지-투-비디오 연동 가이드: 첫 프레임, 마지막 프레임, 초 단위 과금

이미지 한 장을 움직이게 하기: 파라미터, 가격, 흔한 실패 원인

Nov 17, 2026
검은색 배경 위 민트색 이산 점 배열로, 점 밀도가 왼쪽에서 오른쪽으로 점점 높아집니다.
모델
seedance-2.5-flash
이 페이지에서

이 모델이 하는 일

seedance-2.5-flash/image-to-video는 ByteDance의 이미지-투-비디오 모델입니다. 이미지 한 장을 첫 프레임으로 업로드하면 모델이 이를 시작점으로 삼아 연속된 영상을 생성하고 오디오도 함께 생성합니다. 화면 비율은 첫 프레임을 따르며 2차 크롭을 하지 않습니다.

확정적인 소재를 시작점으로 삼는 시나리오에 적합합니다: 제품 이미지의 동적 전시, 캐릭터 일러스트의 미세 표정과 신체 동작, 콘티 스케치의 동적 프리비즈, 콘텐츠 풀을 대량으로 채워야 하는 단편. "문장 하나만 주면 완전한 내러티브를 생성"하는 요구에는 적합하지 않으며, 그건 텍스트-투-비디오 라인의 일입니다.

요청 파라미터

  • prompt (필수): 원하는 동작, 카메라 무빙, 장면, 사운드를 설명하며 최대 5000자입니다.
  • first_frame_url (필수): 첫 프레임 이미지. jpeg, png, webp, bmp, tiff, gif, heic, heif를 지원하며 장당 30 MB 이하, 각 변 300~6000 픽셀, 가로세로 비율 0.4~2.5입니다.
  • last_frame_url (선택): 마지막 프레임 이미지로 제약은 첫 프레임과 같습니다. 비율이 맞지 않으면 중앙 크롭으로 정렬합니다. 마지막 프레임을 전달하면 첫 프레임도 반드시 함께 전달해야 합니다.
  • resolution: 480p 또는 720p, 기본값 480p.
  • duration: 4~30 사이의 정수, 기본값 5, 단위는 초입니다.
  • aspect_ratio: adaptive만 허용되며 출력 비율은 첫 프레임 이미지를 따릅니다.
  • output_format: mp4(기본) 또는 mov.
  • generate_audio: 기본값 true.

초 단위 과금

  • 480p: $0.0679/초
  • 720p: $0.1525/초

과금 초수는 요청한 duration과 같습니다. 자주 쓰는 구간: 480p 4초 $0.2716, 720p 4초 $0.61, 480p 10초 $0.679, 720p 10초 $1.525. 첫 프레임과 마지막 프레임 이미지 자체는 추가 과금되지 않습니다.

초 단위로 과금되므로 재시도는 곧 중복 결제입니다. "첫 프레임이 적합한지"를 제출 전에 판단하는 편이 생성 후 다시 하는 것보다 훨씬 저렴합니다.

첫 프레임이 결과물의 상한을 결정한다

모델은 첫 프레임에 이미 있는 정보만으로 확장할 수 있으므로, 첫 프레임의 품질이 사실상 결과의 상한을 결정합니다:

  • 주체가 선명하고 화면에서 차지하는 비중이 적절해야 합니다 — 주체가 너무 작으면 모델이 무엇을 움직여야 할지 판단하기 어렵습니다.
  • 강한 블러와 노이즈를 피하세요. 저품질 입력은 매 프레임에서 증폭됩니다.
  • 화면 가장자리에 주의하세요. 잘린 주체는 움직일 때 변형되기 쉽습니다.
  • 화면 속 텍스트는 움직임 속에서 안정적으로 유지되기 어렵습니다. 애초에 중요한 요소가 아니라면 말입니다.
  • 같은 주체로 후보 첫 프레임을 여러 장 준비하는 편이 프롬프트를 반복 조정하는 것보다 효과적입니다.

길이는 비용이자 품질 변수

클립이 길수록 모델이 일관성을 유지해야 하는 프레임 수가 늘어나고, 드리프트와 왜곡이 누적될 확률이 높아집니다. 먼저 4~5초로 첫 프레임과 운동 방향이 성립하는지 검증하고, 확인 후 필요에 따라 늘리세요. 긴 콘텐츠는 한 번의 긴 생성에 의존하지 말고 "여러 짧은 클립 + 후반 작업 이어붙이기"로 구성하는 것이 좋습니다.

흔한 실패와 진단 순서

  1. 제출하자마자 파라미터 오류: 먼저 이미지가 제한을 초과했는지(용량, 변 길이, 가로세로 비율, 형식), 그리고 last_frame_url만 전달하고 첫 프레임을 전달하지 않았는지 확인하세요.
  2. 화면 주체 변형: 대부분 첫 프레임의 주체가 너무 작거나, 가장자리가 잘렸거나, 동작 폭 요구가 과도한 경우입니다. 첫 프레임을 바꾸거나 동작을 작게 서술하세요.
  3. 비율이 예상과 다름: 이 라인은 adaptive로 고정되어 출력이 첫 프레임을 따릅니다. 16:9나 9:16을 원한다면 첫 프레임에서 정하세요.
  4. 콘텐츠 차단: 첫 프레임 자체도 규정 심사를 통과해야 하며, 이미지에 무엇이 있느냐가 호출 성립 여부를 직접 결정합니다.
  5. 클라이언트는 타임아웃인데 작업은 실제로 성공: 영상 생성은 시간이 오래 걸리므로 클라이언트 타임아웃을 너무 짧게 두면 성공을 실패로 오인하고, 재제출하면 또 중복 과금됩니다. 비동기 작업으로 처리하고 타임아웃을 넉넉히 주세요.

출시 권장 사항

먼저 서로 다른 유형의 첫 프레임 3~5장으로 파이프라인을 끝까지 돌려 제출, 폴링, 다운로드가 모두 통과하는지 확인하세요. 그다음 첫 프레임을 고정하고 프롬프트만 바꾸면서 어떤 동작 서술에 모델이 잘 반응하는지 파악하세요. 마지막으로 비율에 맞춰 물량을 늘리며 성공률, 평균 소요 시간, 재시도율을 주시하세요. 파라미터와 가격은 모델 페이지의 현행 설명을 기준으로 합니다.

영구 AI 아티팩트로 빌드 시작하기

API 키를 받아 태스크 기반의 하나의 API로 이미지, 비디오, 오디오 모델을 호출하세요.

API 문서 보기