Seedance 동영상 생성

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'prompt="A matte magenta cube rotates slowly above a cyan studio floor while a small yellow sphere circles it."' \
  -F 'model="seedance-2-5"' \
  -F 'seconds="4"' \
  -F 'size="1280x720"'

{
  "id": "task_abc123",
  "task_id": "task_abc123",
  "object": "video",
  "model": "doubao-seedance-2-0-mini",
  "status": "queued",
  "progress": 0,
  "created_at": 1776681149
}

size에 모델의 크기 표에 있는 WxH 값을 설정하세요.

Seedance 2.0 Mini에는 doubao-seedance-2-0-mini을 정확히 사용하세요. 축약된 seedance-mini 값은 유효한 모델 ID가 아닙니다.

지원되는 모델 ID

입력 모드와 해상도에 맞는 모델을 선택한 다음, model 필드에 해당 모델의 정확한 ID를 전송하세요.

모델	정확한 모델 ID	모드 및 해상도 등급	지원됨 `seconds`
Seedance 2.5	`seedance-2-5`	텍스트-동영상, 참조 미디어; `480p`, `720p`	`4`-`30`
Seedance 2.0	`doubao-seedance-2-0`	텍스트-동영상, 참조 미디어; `480p`, `720p`, `1080p`, `4K`	`4`-`15`
Seedance 2.0 Fast	`doubao-seedance-2-0-fast`	텍스트-동영상, 참조 미디어; `480p`, `720p`	`4`-`15`
Seedance 2.0 Mini	`doubao-seedance-2-0-mini`	텍스트-동영상, 참조 미디어; `480p`, `720p`	`4`-`15`
Seedance 1.5 Pro	`doubao-seedance-1-5-pro`	텍스트-동영상, 이미지-동영상; `480p`, `720p`, `1080p`	`4`-`12`
Seedance 1.0 Pro	`doubao-seedance-1-0-pro`	텍스트-동영상, 이미지-동영상; `480p`, `720p`, `1080p`	`2`-`10`

참조 이미지 사용

POST /v1/videos을 multipart/form-data로 전송하고, 참조 이미지는 input_reference에 포함하세요. 여러 이미지의 경우 이미지 순서대로 필드를 반복하고, 각 필드에는 공개적으로 액세스 가능한 HTTPS 이미지 URL 하나 또는 업로드된 이미지 파일 하나를 지정하세요. 이 필드 내에서는 URL만 또는 파일만 사용하세요. URL을 쉼표로 연결하지 말고 각각 별도로 전송하세요. 업로드된 각 이미지는 20 MiB 이하로 유지하세요(20 × 1024 × 1024바이트). Seedance 1.0 Pro 및 1.5 Pro는 참조 이미지 하나를 사용합니다. Seedance 2.0, Fast 및 Mini는 참조 이미지 최대 9개를 지원합니다. Seedance 2.5는 참조 이미지 최대 30개를 지원합니다. 이 개수는 URL과 업로드된 파일 모두에 적용됩니다. 프롬프트(Prompt)에서 각 이미지에 피사체, 배경 또는 시각적 스타일 등의 역할을 지정하세요. 유지할 외관, 동작, 카메라 움직임을 설명하세요. 이 페이지 상단의 요청 샘플에는 이미지 URL 입력과 단일 이미지 또는 여러 이미지 업로드가 나와 있습니다.

참조 이미지 URL 전송

피사체 외관과 배경을 안내하려면 이미지 URL 두 개를 사용하세요:

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=doubao-seedance-2-0' \
  --form-string 'prompt=Use the subject in @Image1 and the setting in @Image2. Use a slow camera push-in and natural motion.' \
  --form-string 'seconds=5' \
  --form-string 'size=1280x720' \
  --form-string 'input_reference=https://your-image-host/subject.png' \
  --form-string 'input_reference=https://your-image-host/setting.png'

참조 동영상 및 오디오 사용

Seedance 2.0, Fast, Mini 및 2.5는 reference_videos 및 reference_audios를 지원합니다. 동영상 참조에는 MP4 파일을, 오디오 참조에는 MP3 파일을 사용하세요. 각각 공개적으로 액세스할 수 있는 HTTPS URL 또는 업로드된 파일로 전송하세요. 참조 오디오는 이미지 또는 동영상 하나 이상과 함께 사용하세요. 프롬프트(Prompt)에서 @Image1, @Video1 및 @Audio1를 사용하여 참조에 역할을 할당하세요. 각 미디어 유형 내의 순서에 따라 참조에 번호를 매기세요. 서로 다른 필드에서 URL과 업로드를 조합할 수 있습니다. input_reference, reference_videos 및 reference_audios 각각에서는 URL만 사용하거나 파일만 사용하세요. 입력이 여러 개인 경우 URL을 쉼표로 연결하지 말고 입력당 필드를 한 번씩 반복하세요.

모델 제품군	참조 이미지	참조 동영상	참조 오디오	총 참조 입력 수
Seedance 2.0, Fast 및 Mini	URL 또는 파일 최대 9개 `input_reference`	최대 3개	최대 3개	최대 12개
Seedance 2.5	URL 또는 파일 최대 30개 `input_reference`	URL 최대 10개 또는 파일 최대 5개	URL 최대 10개 또는 파일 최대 5개	최대 50개

업로드하는 각 동영상은 50 MiB 이하, 각 오디오 파일은 15 MiB 이하로 유지하세요. 1 MiB는 1024 × 1024바이트입니다. 표준 Seedance 2.0(doubao-seedance-2-0)에는 URL과 업로드 파일 모두에 적용되는 추가 미디어 제한이 있습니다. 참조 동영상의 총 길이는 2~15초로, 총 크기는 50 MB 미만으로 유지하세요. 참조 동영상 해상도는 약 480p(640x640)에서 720p(834x1112). 참조 오디오의 총 길이는 15초 이하로, 각 파일은 15 MB 이하로 유지하세요. 업로드한 미디어는 위의 파일당 업로드 제한도 충족해야 합니다.

참조 동영상 URL 전송

참조 동영상을 사용하여 카메라 움직임과 동작을 안내하세요:

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=doubao-seedance-2-0' \
  --form-string 'prompt=Follow the camera movement and action in @Video1. Preserve the direction and pace of the motion.' \
  --form-string 'seconds=5' \
  --form-string 'size=1280x720' \
  --form-string 'reference_videos=https://your-media-host/reference.mp4'

이미지 URL과 오디오 페어링

참조 오디오의 리듬에 맞춰 참조 피사체에 애니메이션을 적용하세요:

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=doubao-seedance-2-0' \
  --form-string 'prompt=Animate the subject in @Image1 to the rhythm of @Audio1. Preserve the subject appearance and use a fixed camera.' \
  --form-string 'seconds=5' \
  --form-string 'size=1280x720' \
  --form-string 'input_reference=https://your-image-host/subject.png' \
  --form-string 'reference_audios=https://your-media-host/reference.mp3'

Seedance 2.5로 참조 미디어 업로드

하나의 요청으로 이미지 두 개, MP4 동영상 및 MP3 오디오 파일을 업로드하세요:

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=seedance-2-5' \
  --form-string 'prompt=Use the subject in @Image1 and the setting in @Image2. Follow the motion in @Video1 and the rhythm of @Audio1.' \
  --form-string 'seconds=5' \
  --form-string 'size=1280x720' \
  --form 'input_reference=@/path/to/subject.png;type=image/png' \
  --form 'input_reference=@/path/to/setting.png;type=image/png' \
  --form 'reference_videos=@/path/to/reference.mp4;type=video/mp4' \
  --form 'reference_audios=@/path/to/reference.mp3;type=audio/mpeg'

모델별 길이

seconds을 모델의 허용 범위 내 정수 형식 값으로 설정하세요. 생략하면 CometAPI는 5초 클립을 요청합니다.

모델 계열	지원 값 `seconds`	기본값	경계값 동작
Seedance 2.5	`4`-`30`	`5`	범위 내의 정수 초 단위를 사용하세요.
Seedance 2.0, Seedance 2.0 Fast 및 Seedance 2.0 Mini	`4`-`15`	`5`	범위 내의 정수 초 단위를 사용하세요.
Seedance 1.5 Pro	`4`-`12`	`5`	범위 내의 정수 초 단위를 사용하세요.
Seedance 1.0 Pro	`2`-`10`	`5`	범위 내의 정수 초 단위를 사용하세요.

모델별 크기 지원

Seedance 2.5

Seedance 2.5에서는 이러한 WxH 값이 텍스트 프롬프트(Prompt)와 참조 미디어 모두에 적용됩니다.

해상도 등급	`16:9`	`4:3`	`1:1`	`3:4`	`9:16`	`21:9`
`480p`	`854x480`	`752x560`	`640x640`	`560x752`	`480x854`	`992x432`
`720p`	`1280x720`	`1112x834`	`960x960`	`834x1112`	`720x1280`	`1470x630`

이전 Seedance 모델

마지막 열은 Seedance 1.5 Pro, 표준 Seedance 2.0 및 Fast의 정확한 WxH 값을 그룹화합니다. Seedance 2.0 Fast는 해당 열에서 480p 및 720p 값만 사용합니다. 해당 열의 1080p 값은 Seedance 1.5 Pro와 표준 Seedance 2.0에 적용됩니다. 4K 값은 표준 Seedance 2.0에만 적용됩니다. Mini 열에서 —은 해당 해상도가 지원되지 않음을 의미합니다.

해상도 등급	화면 비율	Seedance 2.0 Mini	Seedance 1.0 시리즈	Seedance 1.5 Pro / 표준 Seedance 2.0 / Fast
`480p`	`16:9`	`864x496`	`864x480`	`864x496`
	`4:3`	`752x560`	`736x544`	`752x560`
	`1:1`	`640x640`	`640x640`	`640x640`
	`3:4`	`560x752`	`544x736`	`560x752`
	`9:16`	`496x864`	`480x864`	`496x864`
	`21:9`	`992x432`	`960x416`	`992x432`
`720p`	`16:9`	`1280x720`	`1248x704`	`1280x720`
	`4:3`	`1112x834`	`1120x832`	`1112x834`
	`1:1`	`960x960`	`960x960`	`960x960`
	`3:4`	`834x1112`	`832x1120`	`834x1112`
	`9:16`	`720x1280`	`704x1248`	`720x1280`
	`21:9`	`1470x630`	`1504x640`	`1470x630`
`1080p`	`16:9`	—	`1920x1088`	`1920x1080`
	`4:3`	—	`1664x1248`	`1664x1248`
	`1:1`	—	`1440x1440`	`1440x1440`
	`3:4`	—	`1248x1664`	`1248x1664`
	`9:16`	—	`1088x1920`	`1080x1920`
	`21:9`	—	`2176x928`	`2206x946`
`4K`	`16:9`	—	—	`3840x2160` (Seedance 2.0 전용)
	`4:3`	—	—	`3326x2494` (Seedance 2.0 전용)
	`1:1`	—	—	`2880x2880` (Seedance 2.0 전용)
	`3:4`	—	—	`2494x3326` (Seedance 2.0 전용)
	`9:16`	—	—	`2160x3840` (Seedance 2.0 전용)
	`21:9`	—	—	`4398x1886` (Seedance 2.0 전용)

Seedance 2.0 Mini는 480p 및 720p을 지원합니다. size을 Mini 열의 WxH 값으로 설정하세요.

인증

Authorization

string

header

필수

Bearer token authentication. Use your CometAPI key.

본문

multipart/form-data

prompt

string

필수

Text prompt that describes the video. Required. When using reference images, describe what each image should control, such as the subject from @Image1, the secondary object from @Image2, and the background or style from @Image3. Also state the action, camera motion, visual style, and scene.

예시:

"A slow cinematic camera push across a coastal landscape at sunrise."

model

enum<string>

필수

Seedance model ID. Use one of the exact values below. Aliases such as seedance-mini are not accepted.

사용 가능한 옵션:

seedance-2-5,

doubao-seedance-2-0,

doubao-seedance-2-0-fast,

doubao-seedance-2-0-mini,

doubao-seedance-1-5-pro,

doubao-seedance-1-0-pro

예시:

"doubao-seedance-2-0-mini"

seconds

integer

기본값:5

Video duration in seconds. Seedance 2.5 accepts 4 to 30. Seedance 2.0, Seedance 2.0 Fast, and Seedance 2.0 Mini accept 4 to 15. Seedance 1.5 Pro accepts 4 to 12, and Seedance 1.0 Pro accepts 2 to 10. The default is 5.

필수 범위: 2 <= x <= 30

예시:

5

size

string

Output size as an exact WxH value. For Seedance 2.5 text-to-video and image-to-video, use 854x480, 752x560, 640x640, 560x752, 480x854, or 992x432 for 480p; use 1280x720, 1112x834, 960x960, 834x1112, 720x1280, or 1470x630 for 720p. For Seedance 2.0 Mini, use 864x496, 752x560, 640x640, 560x752, 496x864, or 992x432 for 480p; use the same documented 720p values. The standard Seedance 2.0 model also accepts its documented 4K values.

Pattern: ^[1-9]\d{2,3}x[1-9]\d{2,3}$

예시:

"854x480"

"480x854"

"864x496"

"752x560"

"640x640"

"560x752"

"496x864"

"992x432"

"1280x720"

"1112x834"

"960x960"

"834x1112"

"720x1280"

"1470x630"

"1920x1080"

"1080x1920"

"3840x2160"

"3326x2494"

"2880x2880"

"2494x3326"

"2160x3840"

"4398x1886"

input_reference

Reference images: repeat input_reference with one publicly accessible HTTPS image URL or one uploaded image file per field. Use only URLs or only files within this field; do not join URLs with commas. Keep each uploaded image at or below 20 MiB. Seedance 2.0, Fast, and Mini allow up to nine image URLs or files and 12 reference inputs in total. Seedance 2.5 allows up to 30 image URLs or files and 50 reference inputs in total. For Seedance 1.0 Pro and 1.5 Pro, send one URL or one file. Submit images in the order you want to reference them in the prompt.

Pattern: ^https://

reference_videos

(string<uri> | file)[]

Reference video inputs for Seedance 2.0, Fast, Mini, and 2.5. Repeat reference_videos with a publicly accessible HTTPS MP4 URL or an uploaded MP4 file. Use only URLs or only files within this field. Each file can be up to 50 MiB. Seedance 2.0, Fast, and Mini allow up to three video inputs and 12 reference inputs in total. Seedance 2.5 allows up to ten video URLs or five uploaded video files, with 50 reference inputs in total. For standard Seedance 2.0 (doubao-seedance-2-0), URL and uploaded references must have a combined video duration of 2 to 15 seconds and a total video size under 50 MB. Each reference video must have a resolution of approximately 480p (640x640) to 720p (834x1112). These media limits apply in addition to the 50 MiB per-file upload limit.

Required array length: 1 - 10 elements

Pattern: ^https://

예시:

"https://your-media-host/reference.mp4"

reference_audios

(string<uri> | file)[]

Reference audio inputs for Seedance 2.0, Fast, Mini, and 2.5. Repeat reference_audios with a publicly accessible HTTPS MP3 URL or an uploaded MP3 file. Use only URLs or only files within this field. Each file can be up to 15 MiB. Seedance 2.0, Fast, and Mini allow up to three audio inputs and 12 reference inputs in total. Seedance 2.5 allows up to ten audio URLs or five uploaded audio files, with 50 reference inputs in total. Pair audio with at least one reference image or video. For standard Seedance 2.0 (doubao-seedance-2-0), URL and uploaded audio references must have a combined duration at or below 15 seconds, with each audio file at or below 15 MB. These media limits apply in addition to the 15 MiB per-file upload limit.

Required array length: 1 - 10 elements

Pattern: ^https://

예시:

"https://your-media-host/reference.mp3"

응답

Task created. Save the returned id and poll GET /v1/videos/{id}.

string

필수

Task id. Use it as the path parameter for GET /v1/videos/{id}.

object

string

필수

Object type, always video.

model

string

필수

Echo of the requested model id.

status

enum<string>

필수

Initial task status. Newly created tasks are returned as queued.

사용 가능한 옵션:

queued,

in_progress,

completed,

failed,

error

progress

integer

필수

Completion percentage. 0 at creation.

필수 범위: 0 <= x <= 100

created_at

integer

필수

Task creation time as a Unix timestamp in seconds.

task_id

string

Alias of id returned for compatibility. The value matches id.

마지막 수정일 2026년 9월 9일

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'prompt="A matte magenta cube rotates slowly above a cyan studio floor while a small yellow sphere circles it."' \
  -F 'model="seedance-2-5"' \
  -F 'seconds="4"' \
  -F 'size="1280x720"'

{
  "id": "task_abc123",
  "task_id": "task_abc123",
  "object": "video",
  "model": "doubao-seedance-2-0-mini",
  "status": "queued",
  "progress": 0,
  "created_at": 1776681149
}

콘텐츠 검토

API 키

지원되는 모델 ID

참조 이미지 사용

참조 이미지 URL 전송

참조 동영상 및 오디오 사용

참조 동영상 URL 전송

이미지 URL과 오디오 페어링

Seedance 2.5로 참조 미디어 업로드

모델별 길이

모델별 크기 지원

Seedance 2.5

이전 Seedance 모델

인증

본문

응답

​지원되는 모델 ID

​참조 이미지 사용

​참조 이미지 URL 전송

​참조 동영상 및 오디오 사용

​참조 동영상 URL 전송

​이미지 URL과 오디오 페어링

​Seedance 2.5로 참조 미디어 업로드

​모델별 길이

​모델별 크기 지원

​Seedance 2.5

​이전 Seedance 모델

인증

본문

응답

지원되는 모델 ID

참조 이미지 사용

참조 이미지 URL 전송

참조 동영상 및 오디오 사용

참조 동영상 URL 전송

이미지 URL과 오디오 페어링

Seedance 2.5로 참조 미디어 업로드

모델별 길이

모델별 크기 지원

Seedance 2.5

이전 Seedance 모델