Skip to main content
POST
WxH 값 중 아래 표에 문서화된 값을 선택하여 size 필드에 사용하세요.
Seedance 2.0 Mini에는 doubao-seedance-2-0-mini을 정확히 사용하세요. 축약된 seedance-mini 값은 유효한 모델 ID가 아닙니다.

지원되는 모델 ID

model 필드에는 다음의 정확한 값 중 하나를 사용하세요.

참조 이미지 사용

Seedance 2.0, Seedance 2.0 Fast 및 Seedance 2.0 Mini에서 지원하는 값은 input_reference입니다. 고급 다중 참조 프롬프트(Prompt)를 지원하는 경로에서는 업로드 순서대로 동일한 multipart 필드를 반복하세요. 단일 input_reference을 포함한 Mini 프로덕션 요청 하나가 720x1280에서 완료되었습니다. 해당 확인으로 요청 완료는 확인되었지만, 참조 이미지가 프롬프트(Prompt)에 미친 시각적 효과를 분리해 확인하지는 못했습니다. Seedance 2.0은 프롬프트(Prompt)가 각 참조 이미지를 장면과 연결하는 방식에 민감합니다. [Image 1], [Image 2], [Image 3]처럼 업로드된 파일을 순서대로 참조한 다음 각 이미지에 명확한 역할을 지정하세요:
  • 주요 피사체, 캐릭터 또는 제품에는 [Image 1]을 사용하세요.
  • 보조 피사체, 소품 또는 동반 대상에는 [Image 2]을 사용하세요.
  • 배경, 설정, 조명 또는 스타일에는 [Image 3]을 사용하세요.
계속 알아볼 수 있어야 하는 요소, 변경 가능한 요소, 동작, 카메라 움직임, 시각적 스타일 및 장면을 설명하세요. 업로드가 수락되었더라도 프롬프트(Prompt)가 모호하면 생성된 동영상이 참조 이미지를 사용하지 않은 것처럼 보일 수 있습니다. 이미지만 나열하는 것보다 다음 프롬프트(Prompt) 구조가 더 안정적입니다:

모델별 길이

seconds을 생략하면 CometAPI는 5초 클립을 요청합니다. 특정 길이가 필요하면 seconds을 문자열로 전송하세요.

모델별 크기 지원

아래 표에는 정확한 WxH 값을 한곳에 정리했습니다. Seedance 2.0 Fast는 다섯 번째 열에서 480p720p 값만 사용합니다. 해당 열의 1080p 값은 Seedance 1.5 Pro 및 표준 Seedance 2.0에 적용됩니다. 4K 값은 표준 Seedance 2.0에만 적용됩니다. Mini 열에서 은 해당 해상도가 지원되지 않음을 의미합니다.
Seedance 2.0 Mini는 480p720p을 지원하지만 1080p 또는 4K은 지원하지 않습니다. 한 프로덕션 점검에서 1920x1080에 대한 Mini 요청은 생성했습니다 1280x720.
대상 모델에 맞는 문서화된 WxH 값을 선택하세요. 정확한 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 uploaded image should control, such as the subject from [Image 1], the secondary object from [Image 2], and the background or style from [Image 3]. 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.

사용 가능한 옵션:
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.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 <= 15
예시:

5

size
string

Output size as an exact WxH value. For Seedance 2.0 Mini, use 864x496, 752x560, 640x640, 560x752, 496x864, or 992x432 for 480p; use 1280x720, 1112x834, 960x960, 834x1112, 720x1280, or 1470x630 for 720p. Mini does not support 1080p or 4K. A Mini request for 1920x1080 produced 1280x720 in one production check. The standard Seedance 2.0 model also accepts its documented 4K values.

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

"864x496"

"752x560"

"640x640"

"560x752"

"496x864"

"992x432"

"1280x720"

"1112x834"

"960x960"

"834x1112"

"720x1280"

"1470x630"

"1920x1080"

"1080x1920"

"3840x2160"

"3326x2494"

"2880x2880"

"2494x3326"

"2160x3840"

"4398x1886"

input_reference
file

Optional reference image uploaded as a multipart file. Seedance 2.0, Seedance 2.0 Fast, and Seedance 2.0 Mini accept this field. On routes that support multiple reference images, repeat the field and reference the files in upload order as [Image 1], [Image 2], and so on. Seedance 1.0 Pro and 1.5 Pro do not accept it.

응답

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

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.