본문으로 건너뛰기

Seedance 2.5

텍스트와 참조 입력으로 영상 구성하기

프레임과 참조의 조합, 편집과 연장, 드래프트 생성 및 결과 보관 조건을 설명합니다.

페이지 목차

지원 기능

Seedance 2.5로는 텍스트만으로 영상을 만들 수 있습니다. 첫 프레임과 마지막 프레임 이미지를 지정하거나 이미지, 영상, 오디오를 참조로 함께 보낼 수도 있습니다. 하려는 일에 맞는 절을 확인합니다.

하려는 일입력확인할 절
텍스트로만 생성prompt입력 방식 선택하기
첫 프레임이나 첫 프레임과 마지막 프레임을 지정해 생성prompt와 프레임 이미지입력 방식 선택하기
이미지, 영상 또는 오디오를 참조해 생성prompt와 references입력 방식 선택하기
영상 참조를 편집하거나 연장영상 참조와 mode입력 방식 선택하기
480p로 방향을 확인한 뒤 1080p 영상 생성draft: true로 만든 드래프트의 작업 ID를 draft_job에 지정드래프트 모드로 확인하고 정식 영상 만들기
실제 인물이 포함된 이미지나 영상을 참조관리형 참조 letsur-asset://…인물이 포함된 참조 준비하기
결과 영상의 마지막 프레임으로 다음 장면 생성앞 요청에 return_last_frame: true마지막 프레임으로 다음 영상 만들기

2.0 계열을 사용한다면 Seedance 2.0 가이드에서 모델별 해상도, 프롬프트 언어와 참조 한도를 확인하세요. 아래 요청은 2.5 기준입니다.

모델 코드와 엔드포인트

요청은 Video Generations의 POST https://gw.letsur.ai/v1/video/generations로 보내고, 응답으로 작업 ID를 받습니다.

모델 코드사용하는 경우
dreamina-seedance-2.5아래 요청 예제의 기준 코드
byteplus-seedance-2.5이전 코드. 계속 사용할 수 있음

작업 조회와 완료 알림의 model에는 요청한 코드가 그대로 반환됩니다.

입력 방식이 포함된 모델 코드를 선택했다면

모델 코드보낼 필드
dreamina-seedance-2.5-reference-to-videoprompt, references
dreamina-seedance-2.5-video-to-videoprompt, mode, videos([{"url": "…"}])

현재 스페이스의 이용 가능 여부와 단가는 에셋에서 확인합니다.

요청 필드와 허용 값

요청 본문은 application/json으로 보냅니다. 필드 이름은 다른 영상 모델과 함께 쓰는 렛서 필드 이름을 따릅니다. 이름이 같은 필드라도 Seedance 2.5에서 허용하는 값과 기본값은 아래 표를 따릅니다. 아래 표에 없는 필드나 공급사 전용 필드 이름은 보내지 마세요.

필드타입요구 여부허용 값과 기본값설명
modelstring필수dreamina-seedance-2.5. 이전 코드 byteplus-seedance-2.5도 사용 가능호출할 모델 코드
promptstring일반 생성과 드래프트 생성에서 필수텍스트만들 영상을 설명하는 텍스트. draft_job으로 정식 생성할 때는 보내지 않음
image_urlstring선택프레임 조합은 아래 입력 방식 참고첫 프레임 이미지
referencesarray선택원소는 아래 표 참고이미지, 영상 또는 오디오 참조
modestring선택. 영상 참조가 있을 때만 보냄reference, edit, extend영상 참조의 처리 방식(참조, 편집, 연장) 선택
durationinteger선택4~30초 또는 자동 선택 -1. 기본 5초, edit와 extend는 기본 -1생성할 영상의 길이(초). edit 조건은 입력 방식 참고
resolutionstring선택480p(기본), 720p, 1080p출력 영상의 해상도. 드래프트는 480p, 드래프트로 만드는 정식 영상은 1080p만 사용
aspect_ratiostring선택21:9, 16:9, 4:3, 1:1, 3:4, 9:16, adaptive. 기본값과 제한은 입력 방식에 따라 다름출력 영상의 화면 비율. 입력 방식 참고
generate_audioboolean선택true(기본) 또는 false오디오 동시 생성 여부
seedinteger선택정수공급사에 전달할 시드. 같은 결과의 재현을 보장하지 않음
watermarkboolean선택true 또는 false워터마크 옵션
return_last_frameboolean선택true 또는 false마지막 프레임 반환 옵션
draftboolean선택true 또는 falsetrue이면 480p 드래프트 생성. 드래프트 모드 참고
draft_jobstring선택완료된 드래프트의 렛서 작업 ID드래프트로 정식 영상을 만들 때 사용. 일반 생성 입력과 함께 보내지 않음
store_mediaboolean선택true 또는 false. 생략하면 스페이스 설정결과 보관 방식. false는 임시 보관, true는 결과 보관. 결과 보관 선택하기 참고

references의 각 원소는 다음 필드로 이루어진 객체입니다. 파일 ID만 문자열로 보내지 마세요.

references[]의 각 원소타입요구 여부허용 값과 기본값
typestring필수image, video, audio
urlstring필수그 입력 종류에서 지원되는 HTTPS URL 또는 업로드 응답의 파일 참조
rolestring선택아래 표 참고

role에 사용할 수 있는 값은 입력 종류에 따라 다릅니다. role을 생략하면 그 입력 종류의 일반 참조 역할이 적용됩니다.

입력 종류사용할 수 있는 rolerole을 생략했을 때
이미지first_frame, last_frame, reference_imagereference_image
영상reference_videoreference_video
오디오reference_audioreference_audio

선택 필드를 생략하면 기본값이 적용됩니다. 명시한 값의 타입이나 범위가 잘못되면 요청이 거절됩니다.

입력 방식 선택하기

먼저 입력 방식을 텍스트, 프레임 지정, 파일 참조 가운데에서 선택합니다. 텍스트만으로 생성할 때는 업로드가 필요 없습니다.

  • 첫 프레임은 한 곳에만

    첫 프레임은 image_url 또는 이미지 참조의 role: "first_frame" 중 한 곳에만 지정합니다.

  • 마지막 프레임에는 첫 프레임도 필요

    첫 프레임 없이 마지막 프레임만 보낼 수 없습니다.

  • 프레임과 일반 참조 중 하나 선택

    프레임 지정은 일반 이미지, 영상 및 오디오 참조와 함께 사용할 수 없습니다.

입력 방식보낼 값조합 조건
텍스트prompt참조 없이 생성. 비율 기본 16:9
첫 프레임image_url 또는 이미지 참조의 role: "first_frame"비율은 생략하거나 adaptive
첫 프레임과 마지막 프레임첫 프레임과 이미지 참조의 role: "last_frame"비율은 생략하거나 adaptive
일반 이미지 참조이미지 참조의 role: "reference_image"이미지의 기본 role
영상 참조영상 참조의 role: "reference_video"mode를 생략하거나 reference로 지정하면 비율 기본 adaptive
영상 편집 또는 연장영상 참조와 mode: "edit" 또는 "extend"비율은 생략하거나 adaptive. edit의 길이는 생략하거나 -1
오디오 참조오디오 참조의 role: "reference_audio"일반 참조 방식으로 사용

파일을 직접 업로드할 때는 참조 파일 업로드 응답으로 받은 값을 사용합니다. 참조 배열의 개수 상한은 제한과 사용량에서 확인합니다.

다음은 업로드한 영상을 참조하는 설명용 본문입니다. letsur-file:// 뒤의 값은 실제 업로드 응답의 값으로 바꾸세요.

{ "model": "dreamina-seedance-2.5", "prompt": "참조 영상의 움직임을 따라 해질녘 해변 장면을 생성해 주세요.", "references": [ {"type": "video", "url": "letsur-file://example-file-id", "role": "reference_video"} ], "mode": "reference", "duration": 5, "resolution": "480p", "aspect_ratio": "adaptive" }

인물이 포함된 참조 준비하기

지원되는 인물 참조 기능을 쓰려면 관리형 참조를 다음 순서로 준비하세요.

  1. References에서 파일을 track=managed로 업로드합니다.
  2. 응답으로 받은 letsur-asset://… 값을 참조로 지정합니다.
업로드에 성공해도 자산 등록이나 영상 생성이 성공한 것은 아닙니다

관리형 참조는 생성에 쓰일 때 공급사의 자산 등록과 심사를 거칩니다. 관리형 참조도 콘텐츠 심사에서 면제되지 않습니다. 사용할 권한이 있는 자료를 준비하세요.

일반 파일 참조 letsur-file://…와 관리형 참조 letsur-asset://…는 역할이 다릅니다. 배경이나 소품 같은 일반 참조에는 지원되는 URL이나 일반 파일 업로드를 쓰고, 공급사 자산 등록이 필요한 입력에는 관리형 참조를 쓰세요. 참조 종류가 달라도 첫 프레임과 일반 참조의 조합 제한은 똑같이 적용됩니다.

고유 기능

드래프트 모드로 확인하고 정식 영상 만들기

480p 드래프트로 제작 방향을 확인한 뒤, 선택한 결과로 1080p 영상을 만듭니다.

두 번의 생성에 각각 과금됩니다

드래프트와 정식 생성에는 각각 비용이 발생합니다. 드래프트라고 해서 같은 480p 일반 생성보다 할인되지는 않습니다.

  1. 480p 드래프트 만들기

    먼저 일반 생성 입력에 draft: true를 추가합니다. 드래프트에는 480p 해상도만 사용할 수 있습니다.

    { "model": "dreamina-seedance-2.5", "prompt": "해질녘 바닷가를 따라 천천히 이동하는 카메라", "duration": 5, "resolution": "480p", "draft": true, "store_media": true }
  2. 결과를 확인하고 1080p로 생성하기

    드래프트 유효기간은 14일입니다

    2026년 10월 28일 11:00(KST) 전에 생성한 드래프트는 7일입니다. 기간은 드래프트 요청을 접수한 시점부터 계산하며, 만료된 드래프트 작업은 정식 생성에 사용할 수 없습니다. 드래프트 유효기간은 결과 파일 보관 기간과 별개입니다. 결과를 보관하거나 링크를 재발급해도 유효기간은 늘어나지 않습니다.

    Jobs로 완료된 결과를 검토한 뒤, 같은 스페이스와 같은 모델의 드래프트 작업 ID를 draft_job에 지정합니다. draft_job에는 렛서 작업 ID를 지정하고, 공급사 작업 ID는 지정하지 않습니다.

    { "model": "dreamina-seedance-2.5", "draft_job": "lst-example-completed-draft-id", "resolution": "1080p", "store_media": true }

    정식 생성 요청에는 prompt, image_url, references, mode, duration, aspect_ratio, draft를 함께 보내지 않습니다. 길이와 비율 등 생성 조건은 드래프트의 조건을 따릅니다. 해상도는 1080p만 사용할 수 있습니다. 조건을 바꾸려면 새 드래프트를 생성합니다.

    정식 생성의 상태와 결과도 새 작업 ID로 확인합니다.

제한과 사용량

참조 배열의 종류별 상한은 이미지 30개, 영상 10개, 오디오 10개입니다. 생성 길이의 범위는 요청 필드와 허용 값의 duration 행에서, 드래프트의 유효기간은 드래프트 모드에서 확인하세요.

업로드 처리 한도와 공급사의 입력 길이, 해상도, FPS, 콘텐츠 조건도 따로 적용됩니다. 배열 상한을 지켰다고 해서 요청이 성공하는 것은 아닙니다.

자동 길이를 쓰거나 영상을 참조하면 비용이 달라질 수 있습니다

자동 길이 -1을 지정하면 고정 길이 대신 모델이 정한 길이가 사용량에 반영됩니다. 영상 참조가 있으면 입력 영상도 사용량에 영향을 줄 수 있습니다.

현재 단가는 에셋에서, 실제 비용 확인 방법은 요청별 비용에서 확인합니다.

결과 받기

접수 응답의 작업 ID로 상태를 확인하고, 결과 파일을 받고, 작업 비용을 확인하는 순서는 다른 영상 모델과 같습니다. 자세한 순서는 생성 요청하고 결과 파일 받기에서 확인합니다.

return_last_frame: true로 받은 마지막 프레임은 다음 장면의 첫 프레임으로 지정할 수 있습니다. 순서는 마지막 프레임으로 다음 영상 만들기에서 확인합니다.

문제 해결

증상다음 행동
프레임 지정과 참조를 함께 보낸 요청이 거절됨프레임 지정과 일반 이미지, 영상, 오디오 참조 가운데 하나만 보냅니다. 조합 조건은 입력 방식 선택하기에 있습니다
드래프트로 정식 영상을 만들 수 없음드래프트 모드에서 드래프트 유효기간이 지났는지, 정식 생성 요청에 함께 보내지 않는 필드를 넣었는지 확인합니다
관리형 참조 업로드는 성공했지만 생성이 실패함관리형 참조는 생성할 때 공급사의 자산 등록과 심사를 거칩니다. 사용할 권한이 있는 자료인지와 콘텐츠 조건을 인물이 포함된 참조 준비하기에서 확인합니다
참조 개수 상한을 지켰는데 거절됨공급사의 입력 길이, 해상도, FPS와 콘텐츠 조건을 제한과 사용량에서 확인합니다

모든 모델에 공통인 오류와 재시도 기준은 오류 처리에서 확인합니다.