Seedance 2.5 Flash API
ByteDance의 Seedance 2.5 Flash 동영상 생성 모델을 위한 전체 API 레퍼런스입니다.
모델 종류
이 API는 세 가지 모델을 지원합니다.
기능 비교
지원하는 화면 비율
텍스트 기반 생성과 참조 자료 기반 생성은 다음 비율을 지원합니다.
21:9, 16:9, 9:16, 1:1, 4:3, 3:4
이미지 기반 생성은 aspect_ratio 매개변수를 지원하지 않습니다.
해상도 옵션
Seedance 2.5 Flash Text to Video
엔드포인트 {#}
POST /api/v1/video/task
요청 매개변수
필수
선택 사항
요청 예시
javascript
Seedance 2.5 Flash Image to Video
요청 매개변수
필수
선택 사항
이미지 기반 동영상 생성 요청에는
aspect_ratio를 포함하지 마세요. 이 모델은 해당 매개변수를 지원하지 않습니다.
요청 예시
javascript
Seedance 2.5 Flash Reference to Video
요청 매개변수
필수
참조 미디어
참조 미디어는 모두 선택 사항입니다. 이미지, 동영상, 오디오 중 한 종류만 사용하거나 참조 미디어 없이 요청할 수 있습니다. 참조 자료가 없다면 텍스트 기반 동영상 생성을 권장합니다.
@ (AT) 참조 자리표시자
@ (AT) 참조 기능은 번호가 붙은 <<<...>>> 자리표시자로 참조 미디어를 프롬프트에 연결합니다. 번호는 미디어 유형별로 1부터 시작하며 해당 배열의 순서를 따릅니다.
예를 들어 첫 번째 이미지는 인물, 두 번째 이미지는 장면을 참조한다면 prompt에서 인물은 <<<image_1>>>, 장면은 <<<image_2>>>로 지정하세요. 각 자리표시자는 해당 배열에 존재하는 항목을 가리켜야 합니다.
선택 사항
요청 예시
javascript
@ (AT) 참조를 사용한 동영상 생성 요청 예시
javascript
미디어 제한
다음 제한은 이 페이지에 나온 모델의 첫 프레임 이미지, 마지막 프레임 이미지 및 참조 미디어에 적용됩니다.
참조 오디오와 참조 동영상의 총길이 제한은 각각 30초입니다. 개수도 별도로 계산하며 이미지 10개, 동영상 5개, 오디오 클립 5개까지 사용할 수 있습니다.
모든 모델에서 resolution과 duration은 필수이며 기본값이 없습니다. 텍스트 기반 생성과 참조 자료 기반 생성에서는 aspect_ratio를 생략하면 16:9가 적용됩니다. 소리 생성의 기본값은 true입니다. 무음 동영상을 생성하려면 false로 설정하세요.
응답 형식
최초 응답
모든 모델은 폴링에 사용할 task_id를 반환합니다.
json
폴링 응답
GET /api/v1/video/{taskId}를 주기적으로 호출해 상태를 확인하세요.
json
상태 값
submitted: 작업이 접수되어 처리 대기 중processing: 동영상 생성 중succeed: 동영상 생성 완료failed: 동영상 생성 실패
처리 시간
처리 시간은 동영상 길이와 해상도, 현재 대기열 상황에 따라 달라집니다.
5–10초 간격으로 폴링하여 상태를 확인하세요.
권장 사항
- 필수 매개변수:
prompt,resolution,duration는 항상 지정하세요. 텍스트 기반 생성과 참조 자료 기반 생성에서aspect_ratio는 선택 사항이며 기본값은16:9입니다 - 이미지 기반 생성의 화면 비율: 이미지로 동영상을 생성하는 요청에는
aspect_ratio를 보내지 마세요 - 참조 동영상: 동영상은 선택 사항입니다. 각 동영상의 길이와 총길이는 위 제한을 준수해야 합니다
- 참조 이미지: 동영상이나 오디오의 유무와 관계없이 이미지는 선택 사항입니다. 지원 형식의 이미지 URL을 최대 10개까지 제출하세요
- 참조 오디오: 각 클립은 2–30초, 15 MB 이하로 유지하고 총길이는 30초를 넘기지 마세요
- 참조 순서:
images,videos,audios의 항목을 의도한 순서로 배치하고 프롬프트에서도 그 순서에 맞게 참조하세요 - 소리:
sound를 생략하면 기본값true가 적용됩니다. 소리 생성을 끄려면false로 설정하세요