doubao-seedance-2-0
doubao-seedance-2.0 영상 생성
- 비동기 처리 모드, 후속 조회를 위한 작업 ID 반환
- 텍스트에서 영상, 이미지에서 영상(첫 프레임/마지막 프레임) 지원
- 참조 영상, 참조 오디오, 유성 영상 지원
- 가로, 세로, 정사각형, 울트라 와이드, 자동 맞춤 등 다양한 비율 지원
POST
인증
요청 매개변수
영상 생성 모델 이름지원되는 모델:
doubao-seedance-2.0- 표준 버전, 텍스트에서 영상, 이미지에서 영상, 첫/마지막 프레임 영상, 참조 영상, 참조 오디오, 유성 영상 지원doubao-seedance-2.0-fast- 빠른 버전, 표준 버전과 동일한 기능, 더 빠른 생성 속도doubao-seedance-2.0-mini- 미니 버전, 표준 버전과 동일한 기능
영상 콘텐츠 설명텍스트에서 영상 생성 시 필수, 이미지에서 영상/영상 참조 생성 시 선택 사항주제, 동작, 카메라 움직임, 스타일을 명확하게 설명하면 더 나은 생성 결과를 얻을 수 있습니다예:
"새끼 고양이가 카메라를 향해 하품한다"영상 길이(초)지원 범위:
4 ~ 15초기본값: 5영상 화면 비율옵션:
16:9- 가로 화면9:16- 세로 화면1:1- 정사각형4:3- 전통적인 비율3:4- 세로 전통적인 비율21:9- 울트라 와이드adaptive- 자동 맞춤(입력 이미지/영상에 맞게 자동 조정)
16:9영상 해상도옵션:
480p- 표준 화질720p- 고화질1080p- Full HD (doubao-seedance-2.0만 지원)4k- Ultra HD (doubao-seedance-2.0만 지원)
720p랜덤 시드, 생성 콘텐츠의 무작위성을 제어하는 데 사용됩니다
- 동일한 요청에서 모델이 다른 seed 값을 받으면 다른 결과를 생성합니다
- 동일한 요청에서 모델이 같은 seed 값을 받으면 유사한 결과를 생성하지만, 완전히 동일하다는 보장은 없습니다
오디오 생성 여부(유성 영상)
true로 설정하면 영상에 AI가 생성한 오디오가 포함됩니다기본값: false마지막 프레임 이미지 반환 여부
true로 설정하면 작업 결과에 영상 마지막 프레임의 이미지 URL이 추가로 반환되며, 연속 영상 생성에 사용할 수 있습니다기본값: false도구 목록, 웹 검색 등 향상된 기능에 사용됩니다예:
[{"type": "web_search"}]이미지 URL 배열, 이미지에서 영상 생성에 사용됩니다두 가지 형식을 지원합니다:
- 일반 이미지 URL:
https://example.com/cat.jpg - Asset URL (심사 통과 소재):
asset://asset_a
["https://example.com/cat.jpg"] 또는 ["asset://asset_a"]Asset URL은
doubao-seedance-2.0 및 doubao-seedance-2.0-fast 모델에서만 지원됩니다. 다른 모델에서는 사용할 수 없습니다.역할이 지정된 이미지 배열, 첫 프레임/마지막 프레임 지정을 지원합니다예:Asset URL 작성법:
url 필드에 Asset URL을 사용하는 경우, doubao-seedance-2.0 및 doubao-seedance-2.0-fast 모델에서만 지원됩니다. 다른 모델에서는 사용할 수 없습니다.참조 영상 URL 배열두 가지 형식을 지원합니다:
- 일반 영상 URL:
https://example.com/reference.mp4 - Asset URL (심사 통과 소재):
asset://asset_a
["https://example.com/reference.mp4"] 또는 ["asset://asset_a"]Asset URL은
doubao-seedance-2.0 및 doubao-seedance-2.0-fast 모델에서만 지원됩니다. 다른 모델에서는 사용할 수 없습니다.참조 오디오 URL 배열두 가지 형식을 지원합니다:
- 일반 오디오 URL:
https://example.com/speech.wav - Asset URL (심사 통과 소재):
asset://asset_a
["https://example.com/speech.wav"] 또는 ["asset://asset_a"]Asset URL은
doubao-seedance-2.0 및 doubao-seedance-2.0-fast 모델에서만 지원됩니다. 다른 모델에서는 사용할 수 없습니다.응답
응답 상태 코드, 성공 시 200
응답 데이터 배열
사용 시나리오
시나리오 1: 텍스트에서 영상
시나리오 2: 이미지에서 영상(첫 프레임)
시나리오 3: 첫/마지막 프레임 영상
시나리오 4: 영상 참조 기반 영상 생성
시나리오 5: 참조 영상 + 참조 오디오
시나리오 6: 유성 영상
시나리오 7: 연속 영상 생성(마지막 프레임 반환)
시나리오 8: 빠른 버전 생성
시나리오 9: 참조 이미지 + 참조 영상 + 참조 오디오 (멀티모달 영상)
참조 이미지, 참조 영상, 참조 오디오를 결합하여 몰입감 있는 1인칭 시점 광고 영상을 생성합니다. 제품 홍보, 브랜드 광고 등 다양한 소스 소재 융합이 필요한 시나리오에 적합합니다.시나리오 10: Asset URL을 사용한 이미지에서 영상 생성
심사 통과된 가상 아바타 소재를 참조 이미지로 직접 전달할 수 있으며, 재업로드나 재심사가 필요하지 않습니다.시나리오 11: Asset URL로 참조 인물 지정 (image_with_roles)
시나리오 12: 고속 버전 + Asset URL 이미지에서 영상 생성
시나리오 13: Asset URL 이미지 + 참조 영상 (동작 전이)
심사 통과된 인물 소재와 참조 영상을 결합하여 지정된 동작을 수행하도록 인물을 유도합니다.작업 결과 조회영상 생성은 비동기 작업으로, 제출 후
task_id를 반환합니다. 작업 상태 가져오기 엔드포인트를 사용하여 생성 진행 상황과 결과를 조회하세요.1.5 Pro 버전과의 차이점
| 특성 | 1.5 Pro | 2.0 / 2.0 fast |
|---|---|---|
| 해상도 | 480p/720p/1080p | 480p/720p/1080p/4k(fast는 480p/720p만) |
| 길이 범위 | 4-12초 | 5-15초 |
| 기본 길이 | 5초 | 5초 |
| 화면 비율 매개변수 | aspect_ratio | size(새로운 adaptive 자동 맞춤 추가) |
| 오디오 생성 | audio 매개변수 | generate_audio 매개변수 |
| 참조 영상 | 미지원 | video_urls 지원 |
| 참조 오디오 | 미지원 | audio_urls 지원 |
| 이미지에서 영상 | image_urls / image_with_roles | image_urls / image_with_roles |
| 유성 영상 | 미지원 | generate_audio 지원 |
| 연속 영상 | 미지원 | return_last_frame 지원 |
| 빠른 버전 | 미지원 | doubao-seedance-2.0-fast 지원 |