Seedance 2.0 비디오 생성(플랫폼 형식)

플랫폼 Video Generations API로 Seedance 2.0 비디오 작업을 생성합니다.

텍스트, 이미지, 비디오 및 오디오 입력을 지원하며 텍스트 기반 비디오 생성, 시작 프레임 또는 시작·종료 프레임 제어, 참조 자료 기반 생성에 사용할 수 있습니다.

Volcengine Ark 요청 구조를 직접 사용하려면 네이티브 형식 생성 API를 참조하세요.

표준 Seedance 2.0은 480p/720p/1080p/4k를 지원하며 Seedance 2.0 fast는 480p/720p만 지원합니다. 실제 사용하는 모델에 맞게 해상도를 선택하세요.

POST/v1/video/generations

비동기 비디오 생성 작업을 생성합니다. 제출에 성공하면 작업 ID를 반환하며 이 API에서 비디오를 동기적으로 반환하지 않습니다.

doubao-seedance-2-0-260128, doubao-seedance-2-0-fast-260128 등의 모델을 지원합니다. 실제 사용 가능한 모델은 현재 API 키가 반환하는 모델 목록을 기준으로 합니다.

인증

bearerAuth

인증Bearer <token>

Authorization Header에 Bearer your-api-key를 사용합니다.

전달 위치: header

요청 본문

application/json

Seedance 2.0 비디오 생성 매개변수입니다.

TypeScript 타입 정의

TypeScript에서 request body 타입을 사용하세요.

model*string

Seedance 2.0 모델 ID 또는 해당 모델이 설정된 추론 접속점(Endpoint) ID입니다. doubao-seedance-2-0-260128, doubao-seedance-2-0-fast-260128을 지원하며 실제 사용 가능 범위는 현재 API 키를 기준으로 합니다.

길이1 <= length

content*array<>

입력 목록입니다. 참조 모드에서는 이미지 9개, 동영상 3개, 오디오 3개까지 사용할 수 있습니다. 각 동영상 또는 오디오는 2~15초이며 같은 유형의 총길이는 15초 이하여야 합니다. 오디오에는 이미지 또는 동영상이 하나 이상 필요합니다. 첫 프레임 또는 첫/마지막 프레임 모드와 멀티모달 참조를 혼합할 수 없습니다.

항목1 <= items

generate_audio?boolean

화면과 동기화된 사운드 생성 여부입니다. true로 설정하면 모델이 프롬프트와 시각적 콘텐츠에 맞는 음성, 효과음 및 배경 음악을 생성할 수 있습니다. false로 설정하면 무음 비디오를 출력합니다.

ratio?string

비디오 화면 비율입니다. Seedance 2.0과 Seedance 2.0 fast는 기본적으로 adaptive를 사용하고 입력에 따라 적절한 화면 비율을 자동으로 선택합니다.

기본값"adaptive"

허용 값

"16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive"

duration?|unknown

생성 비디오 길이이며 단위는 초입니다. Seedance 2.0과 Seedance 2.0 fast는 4~15의 정수 또는 모델이 길이를 결정하는 -1을 지원합니다.

resolution?string

동영상 해상도로 기본값은 720p입니다. 표준 Seedance 2.0은 480p/720p/1080p/4k, Seedance 2.0 fast는 480p/720p만 지원합니다.

기본값"720p"

허용 값

"480p"
"720p"
"1080p"
"4k"

watermark?boolean

생성 비디오에 워터마크 추가 여부입니다.

seed?integer

난수 시드이며 범위는 -1~4294967295입니다. 같은 시드는 결과 재현성을 높일 수 있지만 완전히 동일한 결과를 보장하지는 않습니다.

범위-1 <= value <= 4294967295

return_last_frame?boolean

연속 동영상 생성에 사용할 워터마크 없는 JPEG 마지막 프레임을 반환할지 여부입니다.

callback_url?string

작업 상태 변경 시 POST callback을 수신할 주소입니다. callback 본문 구조는 작업 조회 API 응답과 같습니다. 설정하지 않으면 작업 상태를 폴링할 수 있습니다.

형식uri

safety_identifier?string

사용 정책을 위반할 가능성이 있는 사용자를 식별하는 데 도움이 되는 최종 사용자의 안정적인 고유 식별자입니다. 사용자 이름, 사용자 ID 또는 이메일을 해시 처리한 문자열을 전달하고 개인정보 제출을 피하는 것을 권장합니다.

길이1 <= length <= 64

execution_expires_after?integer

생성 시점부터 계산한 작업 유효 시간이며 단위는 초입니다. 이 시간이 지나도 완료되지 않은 작업은 종료되고 expired로 표시됩니다.

형식int32

범위3600 <= value <= 259200

기본값172800

tools?array<>

모델이 호출할 수 있는 도구 목록입니다. 예를 들어 web_search입니다. 도구 유형과 확장 매개변수는 현재 모델 및 계정 기능을 기준으로 합니다.

service_tier?string

작업에 사용하는 서비스 등급입니다. Seedance 2.0과 Seedance 2.0 fast는 default 온라인 추론 서비스를 사용하며 flex 오프라인 추론을 지원하지 않습니다.

기본값"default"

priority?integer

동일한 추론 엔드포인트 내 대기열 우선순위로 0~9입니다. 값이 클수록 우선하며 같은 우선순위는 제출 순서대로 처리됩니다. 실행 중인 작업은 중단하지 않습니다.

범위0 <= value <= 9

기본값0

응답 본문

`application/json`

curl -X POST "https://example.com/v1/video/generations" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "content": [
      {
        "type": "text",
        "text": "크리스마스 토끼가 날아가고 있습니다"
      }
    ],
    "generate_audio": true,
    "ratio": "16:9",
    "duration": 11,
    "resolution": "1080p",
    "watermark": false,
    "execution_expires_after": 172800
  }'

{
  "id": "cgt-20260330164007-wnc8k",
  "task_id": "cgt-20260330164007-wnc8k",
  "object": "video",
  "model": "MODEL_ID",
  "status": "queued",
  "progress": 0,
  "created_at": 1774860007
}

Volcengine Ark 비디오 생성 작업 공식 문서Seedance 비디오 생성 작업의 업스트림 프로토콜 정의와 최신 필드 변경 사항을 확인합니다.

Seedance 2.0 비디오 생성(플랫폼 형식)

인증

요청 본문

응답 본문

200application/json

400application/json

401application/json

402application/json

429application/json

500application/json

502application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`