ByteDance의 플래그십 멀티모달 비디오 모델입니다. 네이티브 오디오와 최대 30초 단일 패스 생성을 지원하며, 이미지 30장·비디오 10개·오디오 10개까지의 대규모 레퍼런스 세트를 받습니다. 텍스트-투-비디오, 이미지-투-비디오, 첫/마지막 프레임 제어, 영상 편집·확장, 립싱크를 모두 한 모델에서 처리합니다.
콘솔의 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",
"input": {
"prompt": "a golden retriever puppy running across a green meadow toward the camera, slow motion, warm afternoon light",
"duration": 5,
"resolution": "720p",
"seed": 42
}
}'| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
prompt | string | No | - | 영상 생성을 위한 텍스트 프롬프트입니다. 최대 20000자(BytePlus 공식 하드캡 없음, 품질은 영어 1,000단어 이내 권장)이며, 미디어 입력(이미지, 레퍼런스 이미지/비디오/오디오)을 제공하는 경우 생략할 수 있습니다. |
duration | integer | Yes | 5 | 영상 길이(초, 4~30)입니다. 필수 항목입니다 — 업스트림은 지능형 길이(-1)도 허용하지만 요청 시점에 결과 길이를 알 수 없어 정확한 과금이 불가능하므로, 본 게이트웨이에서는 명시적인 길이를 요구합니다. |
resolution | string | No | 720p | 영상 해상도입니다. 1080p는 더 높은 초당 요율로 과금됩니다. 480p720p1080p |
image | string | No | - | 이미지-투-비디오 또는 첫/마지막 프레임 생성을 위한 첫 프레임 이미지입니다. 레퍼런스 이미지·비디오·오디오와 함께 사용할 수 없습니다. |
last_frame_image | string | No | - | 마지막 프레임 이미지입니다. 첫 프레임 이미지가 함께 있어야 하며, 레퍼런스 이미지·비디오·오디오와는 사용할 수 없습니다. |
reference_images | array | No | - | 캐릭터 일관성, 스타일 가이드, 장면 구성을 위한 레퍼런스 이미지(최대 30장)입니다. 첫/마지막 프레임 이미지와 함께 사용할 수 없으며, 프롬프트에서 [Image1], [Image2] 형태로 지칭합니다. |
reference_videos | array | No | - | 모션 트랜스퍼, 스타일 레퍼런스, 편집·확장을 위한 레퍼런스 비디오(최대 10개, 합산 30초)입니다. 레퍼런스 비디오를 하나라도 제공하면 더 비싼 video_in 요율로 과금됩니다. |
reference_audios | array | No | - | 오디오 기반 생성과 립싱크를 위한 레퍼런스 오디오(최대 10개, 합산 30초)입니다. 레퍼런스 이미지 또는 비디오가 최소 하나 필요합니다. |
aspect_ratio | string | No | adaptive | 영상 화면비입니다. 기본값 'adaptive'는 입력에 맞는 비율을 모델이 선택합니다. 첫/마지막 프레임, 편집, 확장 모드에서는 'adaptive'가 필요합니다. adaptive16:94:31:13:49:1621:9 |
generate_audio | boolean | No | true | 영상과 동기화된 오디오(큰따옴표로 적은 대사, 효과음, 배경음악)를 함께 생성합니다. |
watermark | boolean | No | false | 생성된 영상에 워터마크를 추가합니다. |
output_format | string | No | mp4 | 출력 영상 컨테이너 포맷입니다. mp4mov |
seed | integer | No | - | 랜덤 시드입니다. 재현 가능한 생성을 위해 지정하며, 완전한 재현성이 보장되지는 않습니다. |
이 모델의 imagelast_frame_imagereference_imagesreference_videosreference_audios 파라미터에 파일을 전달하는 방법은 3가지입니다.
공개 접근 가능한 URL을 직접 전달합니다. Storage API(POST /v1/files/upload-url)로 업로드하면 파일이 S3로 직접 올라가고(파일당 50MB), 반환된 file_url을 그대로 쓰면 됩니다.
{
"model": "bytedance/seedance-2.5",
"input": {
"prompt": "your prompt here",
"image": "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" \
-F 'input={"prompt":"your prompt here"}' \
-F "file:image=@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로도 제공 |
프롬프트만으로 생성한 5초 720p 클립으로, 동기화된 앰비언스가 같은 패스에서 함께 만들어집니다.
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",
"input": {
"prompt": "a golden retriever puppy running across a green meadow toward the camera, slow motion, warm afternoon light",
"duration": 5,
"resolution": "720p",
"seed": 42
}
}'레퍼런스 이미지와 레퍼런스 비디오를 함께 넣고, 프롬프트에서 각 입력을 지칭하며 조합 방식을 서술합니다.
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",
"input": {
"prompt": "The character from [Image1] performs the dance from [Video1] on a neon-lit stage.",
"reference_images": [
"https://example.com/character.jpg"
],
"reference_videos": [
"https://example.com/dance-reference.mp4"
],
"duration": 8,
"resolution": "720p",
"aspect_ratio": "adaptive"
}
}'