Seedance 2.5

Seedance 영상 생성에 사용할 입력과 생성 조건을 확인하세요.

텍스트로 영상 생성, 시작과 끝 프레임 지정, 참조 입력 및 영상 편집 또는 연장에 따라 요청 조건이 달라집니다.

모델 선택과 호출 경로

모델 코드는 byteplus-seedance-2.5입니다. 현재 스페이스의 이용 가능 여부와 적용 단가는 모델 선택에서 확인합니다. 호출은 Video Generations, 접수 이후 상태와 결과는 Jobs를 사용합니다.

입력 방식 선택하기

참조 항목은 type, url, role로 구성합니다. type은 image, video, audio이며, url에는 해당 입력에서 지원하는 HTTPS URL 또는 업로드한 파일 참조를 넣습니다. 직접 업로드할 때는 참조 파일 업로드의 반환값을 사용합니다. 텍스트만으로 생성할 때는 업로드가 필요 없습니다.

입력 방식	보낼 값	조합 조건
텍스트	`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"`	일반 참조 방식으로 사용. 프레임 지정과 섞지 않음

프레임 지정은 일반 이미지, 영상 및 오디오 참조와 함께 사용할 수 없습니다. 참조 배열의 종류별 상한은 이미지 30개, 영상 10개, 오디오 10개입니다. 업로드 처리 한도와 공급사의 입력 길이, 해상도 및 콘텐츠 조건도 별도로 적용되므로 배열 상한만으로 요청 성공을 판단하지 않습니다.

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


{
  "model": "byteplus-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"
}

생성 조건 정하기

일반 생성은 기본 5초, 480p이며 텍스트 입력의 기본 비율은 16:9입니다. generate_audio는 기본 true입니다. 생성 길이는 4–30초 또는 자동 선택 -1, 해상도는 480p, 720p, 1080p를 사용합니다. edit와 extend의 기본 길이는 -1입니다. 모드별 비율과 길이 제한은 위 입력 조합을 함께 따릅니다.

자동 길이 -1은 모델이 정한 길이가 사용량에 반영되므로 고정 길이 요청과 비용이 달라질 수 있습니다. 영상 참조가 있으면 입력 영상도 사용량에 영향을 줄 수 있습니다. seed가 같아도 동일한 결과를 보장하지 않습니다. 현재 단가와 비용 확인 방법은 요청별 비용을 따릅니다.

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

지원되는 인물 참조 기능을 사용하려면 References에서 track=managed로 업로드하고 반환된 letsur-asset://…를 입력합니다. 이 참조는 생성에 사용할 때 공급사의 자산 등록과 심사를 거칩니다. 업로드 성공이 자산 등록이나 영상 생성 성공을 뜻하지 않으며, 콘텐츠 심사를 면제하지 않습니다. 사용할 권한이 있는 자료를 준비하세요.

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

결과 보관과 다음 작업

store_media를 생략하면 스페이스 설정을 따릅니다. false는 결과 전달을 위한 임시 보관, true는 결과를 보관해 후속 작업에 사용하는 선택입니다. false도 파일 복사를 건너뛰지 않으며 임시 보관은 약 1시간입니다. 임시 보관 만료는 첫 파일 복사를 접수한 시점부터 링크 유효기간(TTL)을 적용해 계산합니다. 파일 준비가 끝난 뒤부터 1시간이 보장되는 것은 아니므로 준비되면 바로 받으세요. 실제 파일 만료와 링크 만료는 Media Links 응답에서 각각 확인합니다.

이 옵션은 당사 결과 파일의 보관을 제어합니다. 참조 원본이나 공급사에 등록된 사본까지 같은 시점에 삭제한다는 의미는 아닙니다. 보관 중에도 서명 링크는 별도로 만료되며 재발급이 파일 보관기간을 늘리지 않습니다.

영상 생성하고 파일 받기에서 수령 흐름을, 마지막 프레임으로 다음 영상 만들기에서 마지막 프레임을 사용하는 흐름을 확인합니다.