Fal.AI를 통해 제공되는 ByteDance Seedance 2.5 레퍼런스-투-비디오 모델입니다. 이미지 30장, 비디오 10개, 오디오 10개까지 총 50개의 멀티모달 레퍼런스를 받아 캐릭터·세트·색감을 최대 30초 전체에 걸쳐 고정합니다. 프롬프트에서 @Image1, @Video1, @Audio1로 각 입력을 지칭하며 모션 트랜스퍼, 편집, 확장, 립싱크에 사용합니다.
콘솔의 Playground에서 별도 코드 없이 이 모델을 즉시 테스트할 수 있어요
이 모델의 사용법을 Claude, ChatGPT 등에 복사
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "bytedance/seedance-2.5/reference-to-video",
"input": {
"prompt": "An octopus finds a football in the ocean and excitedly calls its octopus friends to come and play. Cut scene to an octopus football game under the sea.",
"image_urls": [
"https://v3b.fal.media/files/b/0a8eba37/Cqg-4Uwzyz4DELfceT1CF_a17e588773ec45b1a9e6f100a787b80b.jpg"
],
"duration": "5",
"resolution": "720p",
"aspect_ratio": "auto",
"generate_audio": true
}
}'| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
prompt | string | Yes | - | 영상 생성을 위한 텍스트 프롬프트입니다. 레퍼런스 입력은 @Image1, @Video1, @Audio1 형태로 지칭하고, 대사는 큰따옴표로 감쌉니다. |
duration | string | Yes | 5 | 영상 길이(초, 4~30)이며 문자열로 전달합니다. 필수 항목입니다 — 업스트림은 "auto"도 허용하지만 요청 시점에 결과 길이를 알 수 없어 정확한 과금이 불가능하므로, 본 게이트웨이에서는 명시적인 길이를 요구합니다. 456789101112131415161718192021222324252627282930 |
image_urls | array | No | - | 영상 생성을 안내하는 레퍼런스 이미지로, 프롬프트에서 @Image1, @Image2로 지칭합니다. JPG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF를 지원하며 이미지당 최대 30MB, 최대 30장입니다. 모든 모달리티를 합쳐 50개를 넘을 수 없습니다. |
video_urls | array | No | - | 영상 생성을 안내하는 레퍼런스 비디오로, 프롬프트에서 @Video1, @Video2로 지칭합니다. MP4, MOV를 지원하며 최대 10개, 각 1.8~30.2초·200MB 이하, 합산 30.2초 이하입니다. 레퍼런스 비디오를 제공하면 출력뿐 아니라 입력 영상까지 과금하는 video_in 요율이 적용됩니다. |
audio_urls | array | No | - | 영상 생성을 안내하는 레퍼런스 오디오로, 프롬프트에서 @Audio1, @Audio2로 지칭합니다. MP3, WAV를 지원하며 최대 10개, 각 1.8~30.2초·15MB 이하, 합산 30.2초 이하입니다. 레퍼런스 이미지 또는 비디오가 최소 하나 필요합니다. |
resolution | string | No | 720p | 영상 해상도입니다. 480p는 빠른 생성, 720p는 균형 잡힌 품질에 적합합니다. 480p720p |
aspect_ratio | string | No | auto | 생성될 영상의 화면비입니다. 가로형은 16:9, 세로형은 9:16, 정사각형은 1:1, 시네마틱 울트라와이드는 21:9를 사용하고, auto로 두면 모델이 선택합니다. auto21:916:94:31:13:49:16 |
generate_audio | boolean | No | true | 효과음, 앰비언스, 립싱크 음성을 포함한 동기화 오디오를 함께 생성할지 여부입니다. 오디오 생성 여부와 관계없이 영상 생성 비용은 동일합니다. |
이 모델의 image_urlsvideo_urlsaudio_urls 파라미터에 파일을 전달하는 방법은 3가지입니다.
공개 접근 가능한 URL을 직접 전달합니다. Storage API(POST /v1/files/upload-url)로 업로드하면 파일이 S3로 직접 올라가고(파일당 50MB), 반환된 file_url을 그대로 쓰면 됩니다.
{
"model": "bytedance/seedance-2.5/reference-to-video",
"input": {
"prompt": "your prompt here",
"image_urls": ["https://example.com/image.jpg"]
}
}POST /v1/predictions/upload에 파일을 직접 첨부합니다. 별도 업로드 과정이 없는 대신, 파일이 API 서버를 거치므로 요청 전체 10MB 제한이 적용됩니다.
curl -X POST "https://api.core.today/v1/predictions/upload" \
-H "X-API-Key: cdt_your_api_key" \
-F "model=bytedance/seedance-2.5/reference-to-video" \
-F 'input={"prompt":"your prompt here"}' \
-F "file:image_urls=@your_file.png"POST /v1/predictions 요청 시 사용되는 공통 파라미터입니다.
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
model | string | Yes | - | 모델 식별자 |
input | object | Yes | - | 위 테이블의 모델별 파라미터를 포함하는 객체 |
output_folder | string | No | - | 결과물 저장 폴더 경로 (최대 256자, '..' 사용 불가) |
webhook_url | string | No | - | 완료 시 호출할 Webhook URL |
is_public | boolean | No | false | true 시 결과물을 영구 공개 URL로도 제공 |
레퍼런스 이미지로 피사체와 스타일을 고정합니다. 레퍼런스 비디오가 없으므로 기본 초당 요율이 적용됩니다.
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "bytedance/seedance-2.5/reference-to-video",
"input": {
"prompt": "An octopus finds a football in the ocean and excitedly calls its octopus friends to come and play. Cut scene to an octopus football game under the sea.",
"image_urls": [
"https://v3b.fal.media/files/b/0a8eba37/Cqg-4Uwzyz4DELfceT1CF_a17e588773ec45b1a9e6f100a787b80b.jpg"
],
"duration": "5",
"resolution": "720p",
"aspect_ratio": "auto",
"generate_audio": true
}
}'레퍼런스 비디오와 제품 이미지를 함께 넣고, 바꿀 것과 유지할 것을 서술합니다. 레퍼런스 비디오는 video_in 요율로 과금됩니다.
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "bytedance/seedance-2.5/reference-to-video",
"input": {
"prompt": "Replace the perfume bottle in @Video1 with the face cream from @Image1, keeping all original motion and lighting.",
"video_urls": [
"https://example.com/original-shot.mp4"
],
"image_urls": [
"https://example.com/face-cream.jpg"
],
"duration": "8",
"resolution": "720p"
}
}'