사용 가이드
Seedance 2.5 Flash 이미지-투-비디오 연동 가이드: 첫 프레임, 마지막 프레임, 초 단위 과금
이미지 한 장을 움직이게 하기: 파라미터, 가격, 흔한 실패 원인
- 모델
- 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초로 첫 프레임과 운동 방향이 성립하는지 검증하고, 확인 후 필요에 따라 늘리세요. 긴 콘텐츠는 한 번의 긴 생성에 의존하지 말고 "여러 짧은 클립 + 후반 작업 이어붙이기"로 구성하는 것이 좋습니다.
흔한 실패와 진단 순서
- 제출하자마자 파라미터 오류: 먼저 이미지가 제한을 초과했는지(용량, 변 길이, 가로세로 비율, 형식), 그리고
last_frame_url만 전달하고 첫 프레임을 전달하지 않았는지 확인하세요. - 화면 주체 변형: 대부분 첫 프레임의 주체가 너무 작거나, 가장자리가 잘렸거나, 동작 폭 요구가 과도한 경우입니다. 첫 프레임을 바꾸거나 동작을 작게 서술하세요.
- 비율이 예상과 다름: 이 라인은
adaptive로 고정되어 출력이 첫 프레임을 따릅니다. 16:9나 9:16을 원한다면 첫 프레임에서 정하세요. - 콘텐츠 차단: 첫 프레임 자체도 규정 심사를 통과해야 하며, 이미지에 무엇이 있느냐가 호출 성립 여부를 직접 결정합니다.
- 클라이언트는 타임아웃인데 작업은 실제로 성공: 영상 생성은 시간이 오래 걸리므로 클라이언트 타임아웃을 너무 짧게 두면 성공을 실패로 오인하고, 재제출하면 또 중복 과금됩니다. 비동기 작업으로 처리하고 타임아웃을 넉넉히 주세요.
출시 권장 사항
먼저 서로 다른 유형의 첫 프레임 3~5장으로 파이프라인을 끝까지 돌려 제출, 폴링, 다운로드가 모두 통과하는지 확인하세요. 그다음 첫 프레임을 고정하고 프롬프트만 바꾸면서 어떤 동작 서술에 모델이 잘 반응하는지 파악하세요. 마지막으로 비율에 맞춰 물량을 늘리며 성공률, 평균 소요 시간, 재시도율을 주시하세요. 파라미터와 가격은 모델 페이지의 현행 설명을 기준으로 합니다.