소개
Seedance 2.0 Fast 레퍼런스→영상은 사용 권한이 있는 여러 소스를 한 샷으로 합칩니다. 이미지는 누구와 무엇을, 클립은 움직임과 템포를, 오디오는 컷이 맞춰 떨어질 박자를 맡습니다. 시작 프레임은 받지 않습니다.
Seedance 2.0 Fast는 ByteDance Seedance 2.0 라인의 고속 등급입니다. 엔드포인트 모두 480p 또는 720p의 4~15초 클립을 돌려주며, 오디오도 화면과 함께 생성합니다.
시작 자료로 Seedance 2.0 Fast 모드 고르기
| 시작 자료 | 모드 |
|---|---|
| 대본이나 장면 설명 | Seedance 2.0 Fast 텍스트→영상 |
| 확정된 시작 이미지 | Seedance 2.0 Fast 이미지→영상 |
| 외형, 움직임, 오디오를 나눈 레퍼런스 | Seedance 2.0 Fast 레퍼런스→영상 |
핵심 기능 및 하이라이트
같은 필드, 세 가지 소스
세 엔드포인트는 모두 같은 기본 필드를 받습니다. prompt, 4~15초의 duration_seconds(-1이면 모델이 길이를 정합니다), 480p 또는 720p의 resolution, aspect_ratio, generate_audio, seed입니다. 달라지는 것은 화면을 고정하는 소스뿐이며, 없음, 시작 프레임, 레퍼런스 묶음 중 하나입니다. 그 소스를 더하거나 빼기만 하면 요청을 다른 모드로 옮길 수 있습니다.
화면과 소리를 한 번에
generate_audio는 기본으로 켜져 있으며 앰비언스, 움직임 효과음, 목소리를 프레임에 맞춰 생성합니다. 이 등급에서는 꺼도 요금이 내려가지 않으므로 무음 루프나 후반 작업에서 음악을 입힐 소재일 때만 끄면 됩니다.
기본은 적응형 화면비
aspect_ratio의 기본값은 adaptive입니다. 이미지→영상은 시작 프레임의 비율을 유지하고, 레퍼런스→영상은 주 레퍼런스를 따르며, 텍스트→영상은 프롬프트가 암시하는 형태를 모델이 고릅니다. 게재 위치가 형태를 정해 두었다면 16:9, 9:16, 4:3, 3:4, 1:1, 21:9 여섯 가지 고정 비율을 쓰면 됩니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 필수이고, 여기서는 캐스팅도 맡습니다. 레퍼런스는 보낸 순서대로 인용되니 어느 이미지가 어느 캐릭터인지, 각 클립이 무엇을 주는지, 오디오가 무엇을 위한 건지 적어 주세요. 1자 이상 |
reference_image_urls | 아니요 | 사용 권한이 있는 이미지 최대 9장으로 캐릭터, 제품, 스타일, 세트를 붙잡아 둡니다. 거의 같은 프레임을 여러 장 쌓는 것보다 같은 대상을 두세 각도에서 담은 이미지가 더 효과적입니다. 9개 이하 |
reference_video_urls | 아니요 | 움직임, 호흡, 카메라 언어를 전하는 클립 최대 3개입니다. 클립마다 2~15초, 전부 합쳐 15초 이하여야 합니다. 3개 이하 |
reference_audio_urls | 아니요 | 오디오 파일 최대 3개로, 각각 2~15초, 합계 15초 이하, 파일당 15MB 미만이어야 합니다. 말투, 템포, 음악 프레이즈 같은 소리의 기준점을 샷에 주고, 움직임과 컷 지점이 거기에 맞춰집니다. 3개 이하 |
aspect_ratio | 아니요 | 출력 구도입니다. 기본값 adaptive에서는 주 레퍼런스의 형태를 따릅니다. |
resolution | 아니요 | 출력 해상도입니다. 480p와 기본인 720p 중에서 고릅니다. |
duration_seconds | 아니요 | 완성 클립의 길이를 정수 초로 지정합니다. 4~15초, 기본 5초이며, -1이면 모델이 길이를 정하고 견적은 15초로 잡습니다. |
generate_audio | 아니요 | 자체 사운드트랙을 화면과 싱크 맞춰 만들지 여부입니다. 기본으로 켜져 있으며, 이 버전에서는 꺼도 요금이 내려가지 않습니다. 기본값: |
seed | 아니요 | 정수 seed입니다. 빼면 실행마다 알아서 뽑습니다. |
return_last_frame | 아니요 | 영상과 함께 클립의 마지막 프레임을 별도 이미지로 돌려줍니다. 다음 첫 프레임으로 image-to-video에 넘기면 정지 화면을 직접 뽑지 않고도 샷을 이어 붙일 수 있습니다. 기본값: |
bitrate_mode | 아니요 | 전달되는 파일의 비트레이트입니다. |
watermark | 아니요 | 모델 자체의 ‘AI generated’ 표시 워터마크를 영상에 넣습니다. 기본값은 꺼짐입니다. 기본값: |
요금
참조 클립의 길이도 과금 대상 초에 합산됩니다. 실행 전에는 클립 길이를 측정할 수 없어 우선 최대 15초분을 선점해 두었다가, 정산 시점에 사용하지 않은 금액을 즉시 돌려드립니다. 실제 사용된 초만 청구됩니다.
| 해상도 | With video: 예 | With video: 아니요 |
|---|---|---|
| $0.022539 / 초 | $0.04499712 / 초 |
| $0.048471 / 초 | $0.096768 / 초 |
활용 사례
모든 각도에서 보는 제품
같은 물체를 두세 방향에서 찍은 이미지가 거의 똑같은 이미지 여러 장보다 형태를 훨씬 잘 붙잡습니다. 공개된 예시는 스니커즈 한 켤레를 세 방향에서 찍은 이미지를 보내고, 가죽 결과 밑창, 끈을 그대로 유지하며 그 순서대로 턴테이블 회전을 요청합니다.
빌려 온 카메라 무빙
레퍼런스 클립은 내용 대신 카메라 언어를 제공할 수도 있습니다. 예시 중 하나는 클립에서 느린 크레인 상승을 가져와 레퍼런스 이미지 속 옥상 위에서 연출하고, 가장 높이 오르는 순간을 레퍼런스 트랙의 고조에 맞춥니다.
시리즈 내내 같은 캐스트
캐릭터, 의상, 공간마다 레퍼런스 세트를 하나씩 두고 요청마다 프롬프트만 바꾸십시오. 같은 이미지가 매 회차를 받쳐 주므로 이야기가 진행되어도 정체성이 유지됩니다.
프롬프트 가이드 및 실전 팁
프롬프트에서 배역 정하기
여기서는 프롬프트가 필수이며 배역을 정하는 역할까지 맡습니다. 레퍼런스는 보낸 순서대로 읽히므로 어떤 이미지가 어떤 캐릭터인지, 각 클립이 무엇을 제공하는지, 오디오는 무엇을 위한 것인지 적으십시오. @Image1, @Image2처럼 부르면 대응 관계가 모호해지지 않습니다.
레퍼런스 한도 지키기
reference_image_urls는 최대 9장, reference_video_urls는 최대 3개, reference_audio_urls는 최대 3트랙입니다. 오디오만으로는 거절되므로 이미지나 클립이 최소 하나 필요합니다. 클립과 오디오는 각각 2~15초, 합계 15초까지이며 레퍼런스 클립의 초는 출력과 별도로 과금되므로 참고할 부분만 잘라서 보내십시오.
포함된 예시 응용하기
공개된 예시는 aspect_ratio 1:1, duration_seconds 5, generate_audio true, resolution 720p를 쓰며, reference_image_urls에 제품 사진 세 장을 넣습니다.
Treat @Image1, @Image2 and @Image3 as three angles of one sneaker. Rotate it smoothly on an invisible turntable through those three views in order, keeping the leather grain, gum sole and lacing identical throughout. Hard studio key stays fixed; the contact shadow swings with the rotation.
모든 레퍼런스를 순서로 부르고 역할은 하나씩만 줍니다. 제품을 바꿔도 이 구조는 유지하십시오.
첫 프레임이 정확해야 하면 이미지→영상으로
이 엔드포인트에는 시작 프레임이나 끝 프레임 필드가 없습니다. 첫 화면이 특정 사진과 정확히 같아야 한다면 그 사진을 이미지→영상으로 보내고 움직임만 적으십시오.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seedance-2.0-fast/reference-to-video",
"input": {
"aspect_ratio": "adaptive",
"bitrate_mode": "standard",
"duration_seconds": 5,
"generate_audio": true,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"reference_image_urls": [
"https://example.com/reference.png"
]
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.
