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-video | prompt, references |
dreamina-seedance-2.5-video-to-video | prompt, mode, videos([{"url": "…"}]) |
현재 스페이스의 이용 가능 여부와 단가는 에셋에서 확인합니다.
요청 필드와 허용 값
요청 본문은 application/json으로 보냅니다. 필드 이름은 다른 영상 모델과 함께 쓰는 렛서 필드 이름을 따릅니다. 이름이 같은 필드라도 Seedance 2.5에서 허용하는 값과 기본값은 아래 표를 따릅니다. 아래 표에 없는 필드나 공급사 전용 필드 이름은 보내지 마세요.
| 필드 | 타입 | 요구 여부 | 허용 값과 기본값 | 설명 |
|---|---|---|---|---|
model | string | 필수 | dreamina-seedance-2.5. 이전 코드 byteplus-seedance-2.5도 사용 가능 | 호출할 모델 코드 |
prompt | string | 일반 생성과 드래프트 생성에서 필수 | 텍스트 | 만들 영상을 설명하는 텍스트. draft_job으로 정식 생성할 때는 보내지 않음 |
image_url | string | 선택 | 프레임 조합은 아래 입력 방식 참고 | 첫 프레임 이미지 |
references | array | 선택 | 원소는 아래 표 참고 | 이미지, 영상 또는 오디오 참조 |
mode | string | 선택. 영상 참조가 있을 때만 보냄 | reference, edit, extend | 영상 참조의 처리 방식(참조, 편집, 연장) 선택 |
duration | integer | 선택 | 4~30초 또는 자동 선택 -1. 기본 5초, edit와 extend는 기본 -1 | 생성할 영상의 길이(초). edit 조건은 입력 방식 참고 |
resolution | string | 선택 | 480p(기본), 720p, 1080p | 출력 영상의 해상도. 드래프트는 480p, 드래프트로 만드는 정식 영상은 1080p만 사용 |
aspect_ratio | string | 선택 | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, adaptive. 기본값과 제한은 입력 방식에 따라 다름 | 출력 영상의 화면 비율. 입력 방식 참고 |
generate_audio | boolean | 선택 | true(기본) 또는 false | 오디오 동시 생성 여부 |
seed | integer | 선택 | 정수 | 공급사에 전달할 시드. 같은 결과의 재현을 보장하지 않음 |
watermark | boolean | 선택 | true 또는 false | 워터마크 옵션 |
return_last_frame | boolean | 선택 | true 또는 false | 마지막 프레임 반환 옵션 |
draft | boolean | 선택 | true 또는 false | true이면 480p 드래프트 생성. 드래프트 모드 참고 |
draft_job | string | 선택 | 완료된 드래프트의 렛서 작업 ID | 드래프트로 정식 영상을 만들 때 사용. 일반 생성 입력과 함께 보내지 않음 |
store_media | boolean | 선택 | true 또는 false. 생략하면 스페이스 설정 | 결과 보관 방식. false는 임시 보관, true는 결과 보관. 결과 보관 선택하기 참고 |
references의 각 원소는 다음 필드로 이루어진 객체입니다. 파일 ID만 문자열로 보내지 마세요.
references[]의 각 원소 | 타입 | 요구 여부 | 허용 값과 기본값 |
|---|---|---|---|
type | string | 필수 | image, video, audio |
url | string | 필수 | 그 입력 종류에서 지원되는 HTTPS URL 또는 업로드 응답의 파일 참조 |
role | string | 선택 | 아래 표 참고 |
role에 사용할 수 있는 값은 입력 종류에 따라 다릅니다. role을 생략하면 그 입력 종류의 일반 참조 역할이 적용됩니다.
| 입력 종류 | 사용할 수 있는 role | role을 생략했을 때 |
|---|---|---|
| 이미지 | first_frame, last_frame, reference_image | reference_image |
| 영상 | reference_video | reference_video |
| 오디오 | reference_audio | reference_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"
}인물이 포함된 참조 준비하기
지원되는 인물 참조 기능을 쓰려면 관리형 참조를 다음 순서로 준비하세요.
- References에서 파일을
track=managed로 업로드합니다. - 응답으로 받은
letsur-asset://…값을 참조로 지정합니다.
관리형 참조는 생성에 쓰일 때 공급사의 자산 등록과 심사를 거칩니다. 관리형 참조도 콘텐츠 심사에서 면제되지 않습니다. 사용할 권한이 있는 자료를 준비하세요.
일반 파일 참조 letsur-file://…와 관리형 참조 letsur-asset://…는 역할이 다릅니다. 배경이나 소품 같은 일반 참조에는 지원되는 URL이나 일반 파일 업로드를 쓰고, 공급사 자산 등록이 필요한 입력에는 관리형 참조를 쓰세요. 참조 종류가 달라도 첫 프레임과 일반 참조의 조합 제한은 똑같이 적용됩니다.
고유 기능
드래프트 모드로 확인하고 정식 영상 만들기
480p 드래프트로 제작 방향을 확인한 뒤, 선택한 결과로 1080p 영상을 만듭니다.
드래프트와 정식 생성에는 각각 비용이 발생합니다. 드래프트라고 해서 같은 480p 일반 생성보다 할인되지는 않습니다.
480p 드래프트 만들기
먼저 일반 생성 입력에
draft: true를 추가합니다. 드래프트에는480p해상도만 사용할 수 있습니다.{ "model": "dreamina-seedance-2.5", "prompt": "해질녘 바닷가를 따라 천천히 이동하는 카메라", "duration": 5, "resolution": "480p", "draft": true, "store_media": true }결과를 확인하고 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와 콘텐츠 조건을 제한과 사용량에서 확인합니다 |
모든 모델에 공통인 오류와 재시도 기준은 오류 처리에서 확인합니다.