Seedance 영상 생성
AceDataCloud의 Seedance(바이트댄스) API를 통해 AI 댄스 및 모션 비디오를 생성합니다.
설정: 토큰 설정은 인증을 참조하세요.
빠른 시작
curl -X POST https://api.acedata.cloud/seedance/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"model": "doubao-seedance-2-0-260128", "content": [{"type": "text", "text": "안개 낀 숲에서 컨템포러리 발레를 추는 무용수"}], "callback_url": "https://api.acedata.cloud/health"}'
비동기: 비동기 작업 폴링을 참조하세요.
POST /seedance/tasks로{"id": "..."}를 전송하여 폴링합니다. 즉시 작업 ID를 반환합니다. 결과를 폴링합니다:
curl -X POST https://api.acedata.cloud/seedance/tasks \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"id": "<위에서 받은 task_id>"}'
모델
Seedance 2.0 (현재 세대 — 멀티모달 참조)
2.0 시리즈는 멀티모달 참조 입력을 추가했습니다: 실제 인물/캐릭터 이미지 참조, 참조 오디오, 참조 비디오 (아래 워크플로우 참조).
| 모델 | 최적 용도 | 최대 해상도 |
|---|---|---|
doubao-seedance-2-0-260128 | 최고 품질, 실제 인물/캐릭터 참조, 4k 출력 | 4k |
doubao-seedance-2-0-fast-260128 | 더 빠른 2.0 생성 | 720p |
doubao-seedance-2-0-mini-260615 | 경량 / 가장 비용 효율적인 2.0 | 720p |
Seedance 1.x
| 모델 | 유형 | 최적 용도 |
|---|---|---|
doubao-seedance-1-5-pro-251215 | 텍스트+이미지-to-비디오 | 1.5 플래그십, 오디오 지원 |
doubao-seedance-1-0-pro-250528 | 텍스트+이미지-to-비디오 | 범용, 안정적인 품질 |
doubao-seedance-1-0-pro-fast-251015 | 텍스트+이미지-to-비디오 | 더 빠른 Pro 생성 |
doubao-seedance-1-0-lite-t2v-250428 | 텍스트-to-비디오 전용 | 경량 텍스트-투-비디오 |
doubao-seedance-1-0-lite-i2v-250428 | 이미지-to-비디오 전용 | 경량 이미지-투-비디오 |
워크플로우
1. 텍스트-to-비디오
content 배열에 텍스트 콘텐츠 항목을 전달합니다.
POST /seedance/videos
{
"model": "doubao-seedance-1-0-pro-250528",
"content": [
{"type": "text", "text": "도시 환경에서 브레이크댄스 동작을 하는 길거리 댄서"}
],
"resolution": "1080p",
"ratio": "16:9",
"duration": 5
}
2. 이미지-to-비디오
텍스트와 함께 이미지 콘텐츠 항목(선택적 role 포함)을 포함합니다.
POST /seedance/videos
{
"model": "doubao-seedance-1-5-pro-251215",
"content": [
{"type": "text", "text": "그 사람이 우아하게 춤추기 시작한다"},
{
"type": "image_url",
"role": "first_frame",
"image_url": {"url": "https://example.com/dancer.jpg"}
}
],
"resolution": "720p",
"duration": 5
}
이미지 역할:
first_frame— 이미지를 시작 프레임으로 사용last_frame— 이미지를 종료 프레임으로 사용reference_image— 이미지를 스타일 / 주제 / 실제 인물 참조로 사용 (Seedance 2.0은 참조된 인물 또는 캐릭터를 일관되게 유지)
참조 미디어 (Seedance 2.0 전용):
audio_url— 음색 / 배경 음악을 위한 참조 오디오 (role없음)video_url— 주제, 카메라 움직임, 모션 또는 전체적인 스타일을 위한 참조 비디오 (role없음)
3. 첫 프레임 + 마지막 프레임
시작과 끝 프레임 이미지를 모두 제공합니다:
POST /seedance/videos
{
"model": "doubao-seedance-2-0-260128",
"content": [
{"type": "text", "text": "두 장면 사이의 부드러운 전환"},
{"type": "image_url", "role": "first_frame", "image_url": {"url": "https://example.com/start.jpg"}},
{"type": "image_url", "role": "last_frame", "image_url": {"url": "https://example.com/end.jpg"}}
]
}
4. 실제 인물 / 캐릭터 참조 (Seedance 2.0)
Seedance 2.0 모델(doubao-seedance-2-0-260128, doubao-seedance-2-0-fast-260128, doubao-seedance-2-0-mini-260615)은 완전히 새로운 장면에서 특정 인물 또는 캐릭터의 일관성을 유지할 수 있습니다. role: "reference_image"인 image_url 항목으로 하나 이상의 사진을 전달하면 모델이 해당 주제의 외형을 보존합니다. 최대 9장의 참조 이미지가 허용됩니다.
POST /seedance/videos
{
"model": "doubao-seedance-2-0-260128",
"content": [
{"type": "text", "text": "네온 불빛이 가득한 야시장을 걷는 같은 사람, 시네마틱"},
{"type": "image_url", "role": "reference_image", "image_url": {"url": "https://example.com/person.jpg"}}
],
"resolution": "1080p",
"duration": 8
}
5. 참조 오디오 / 비디오 (Seedance 2.0)
2.0 모델은 참조 오디오(음색, 배경 음악)와 참조 비디오(주제 콘텐츠, 카메라 움직임, 모션, 전체적인 스타일)도 허용합니다. audio_url 및/또는 video_url 콘텐츠 항목을 추가합니다. 제한: 요청당 최대 3개의 오디오 및 3개의 비디오 참조.
POST /seedance/videos
{
"model": "doubao-seedance-2-0-260128",
"content": [
{"type": "text", "text": "무대에서 공연하는 가수, 참조 음성과 움직임 일치"},
{"type": "image_url", "role": "reference_image", "image_url": {"url": "https://example.com/person.jpg"}},
{"type": "audio_url", "audio_url": {"url": "https://example.com/voice.mp3"}},
{"type": "video_url", "video_url": {"url": "https://example.com/motion.mp4"}}
],
"generate_audio": true
}
매개변수
| 매개변수 | 값 | 설명 |
|---|---|---|
model | 모델 표 참조 | 사용할 모델 (필수) |
content | 배열 | 입력 항목: text, image_url, audio_url (2.0), video_url (2.0) (필수) |
resolution | "480p", "720p", "1080p", "4k" | 출력 해상도. 4k는 doubao-seedance-2-0-260128 (표준) 전용; 2-0-fast / 2-0-mini는 최대 720p (기본값: pro/2.0은 720p, lite는 480p) |
ratio | "16:9", "4:3", "1:1", "3:4", "9:16", "21:9", "adaptive" | 화면 비율 (기본값: 16:9) |
duration | 2 – 15 | 길이(초) (Seedance 2.0은 4–15 지원) |
frames | 29–361 (25+4n 만족해야 함) | 프레임 수 — duration과 상호 배타적 |
seed | -1 ~ 4294967295 | 재현 가능한 결과를 위한 시드 (-1 = 무작위) |
generate_audio | true / false | 오디오 생성 (doubao-seedance-1-5-pro-251215 및 doubao-seedance-2-0 시리즈 지원; 다른 모델은 무시) |
camerafixed | true / false | 생성 중 카메라 위치 고정 |
watermark | true / false | 생성된 비디오에 워터마크 추가 |
return_last_frame | true / false | 생성된 비디오의 마지막 프레임 반환 |
service_tier | "default", "flex" | 처리 계층 (기본값: default) |
execution_expires_after | 숫자 | 작업 시간 초과 임계값(초) |
인라인 매개변수 구문
--param value 구문을 사용하여 텍스트 프롬프트에 생성 매개변수를 직접 포함할 수도 있습니다:
카메라를 응시하는 고양이 새끼. --rs 720p --rt 16:9 --dur 5 --fps 24 --seed 42
지원되는 인라인 매개변수: --rs (해상도), --rt (비율), --dur (길이), --frames, --fps (24만), --seed, --cf (camera_fixed), --wm (워터마크).
주의 사항
- 모델 이름은
doubao-*규칙을 사용합니다 (예:doubao-seedance-1-0-pro-250528) —seedance-1.0과 같은 이전 짧은 이름은 유효하지 않습니다 content배열은 이전prompt+image_url필드를 대체합니다. 항상content를 사용하세요- 이미지와 텍스트 시나리오는 콘텐츠 항목별로 상호 배타적입니다. 각 항목은
text또는image_url중 하나만 가집니다 (둘 다 가질 수 없음) first_frame과last_frame은 하나의 요청에서 결합될 수 있지만,reference_image는first_frame/last_frame과 상호 배타적입니다 — 참조 이미지를 첫/마지막 프레임과 혼합하지 마세요generate_audio: true는doubao-seedance-1-5-pro-251215및doubao-seedance-2-0시리즈에서 지원됩니다. 다른 모델은 이 필드를 무시합니다- Lite 모델은 분할됩니다:
*-lite-t2v-*는 텍스트만 허용,*-lite-i2v-*는 이미지-투-비디오만 허용 audio_url및video_url참조 항목은 Seedance 2.0 시리즈에서만 사용됩니다- 해상도 옵션은
480p,720p,1080p,4k입니다 (4k는doubao-seedance-2-0-260128전용;2-0-fast/2-0-mini는 최대720p) — 360p 또는 540p는 없습니다 service_tier값은"default"와"flex"입니다 ("standard"/"premium"이 아님)- 길이 범위는 2~15초입니다 (Seedance 2.0은 4~15 지원) — 이 범위를 벗어난 값은 실패합니다
- 작업 상태는
"succeeded"를 사용합니다 ("completed"가 아님) — 폴링 시 이 값을 확인하세요
MCP:
pip install mcp-seedance| 호스팅:https://seedance.mcp.acedata.cloud/mcp| 모든 MCP 서버 참조