Seedance 2.5 비디오 생성(네이티브 형식)

Volcengine Ark 네이티브 API로 Seedance 2.5 비디오 작업을 생성합니다.

텍스트, 이미지, 비디오 및 오디오 참조 입력을 지원하며 Volcengine Ark 네이티브 작업 ID를 직접 반환합니다.

플랫폼 공통 작업 구조를 사용하려면 플랫폼 형식 생성 API를 참조하세요.

낮은 해상도의 샘플을 먼저 확인한 뒤 최종 영상을 만들려면 Draft 샘플 영상 생성 가이드를 참조하세요. 샘플은 480p, 샘플을 기반으로 생성하는 최종 영상은 1080p를 사용합니다.

POST/api/v3/contents/generations/tasks

Volcengine Ark 네이티브 경로로 Seedance 2.5 비동기 비디오 작업을 생성합니다. 핵심 요청 매개변수는 호환 경로와 같으며 성공 시 네이티브 형식의 작업 ID를 반환합니다.

요청 내용, 자료 제한, 작업 유형 제약 및 출력 형식 규칙은 호환 생성 API와 같습니다.

인증

bearerAuth

인증Bearer <token>

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

전달 위치: header

요청 본문

application/json

Seedance 2.5 네이티브 비디오 생성 매개변수입니다.

TypeScript 타입 정의

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

model*string

Seedance 2.5 모델 ID입니다. 예를 들어 doubao-seedance-2-5-260628입니다. 실제 호출 시 현재 API 키에 표시되는 모델을 기준으로 합니다.

길이1 <= length

content*array<|>

텍스트, 이미지, 동영상, 오디오 또는 Draft 작업 ID로 구성된 입력 목록입니다. 멀티모달 참조는 최대 50개 자료(이미지 30개, 동영상 10개, 오디오 10개)를 지원합니다. 각 동영상과 오디오는 2~~30초이며 같은 유형의 총길이는 30초 이하여야 합니다. 편집용 참조 동영상은 4~~30초여야 합니다. 오디오만 참조할 수 있습니다. 첫 프레임 또는 첫/마지막 프레임 모드와 멀티모달 참조는 혼합할 수 없습니다.

프롬프트에서 배열 순서대로 @image1, @video1, @audio1로 자료를 참조합니다.

항목1 <= items

draft?boolean

Draft 미리보기를 생성할지 여부입니다. true이면 480p를 사용해야 합니다. 성공 후 7일 이내에 content.draft_task.id를 참조하여 1080p 최종 동영상을 생성합니다. 최종 생성에서는 생략하거나 false로 설정합니다.

omni_reference_task_type?string

멀티모달 참조 작업 유형입니다. auto는 자동 판정, reference는 참조 생성, edit는 편집(참조 동영상, ratio=adaptive, duration=-1 필요), extend는 연장(참조 동영상과 ratio=adaptive 필요)입니다. 유형을 명시하면 제약 조건을 사전 검사합니다. 프롬프트 의도도 선택한 유형과 일치해야 합니다.

기본값"auto"

허용 값

"auto"
"reference"
"edit"
"extend"

generate_audio?boolean

화면에 맞는 오디오 생성 여부입니다. 활성화하면 일반적으로 생성 시간과 과금 비용이 늘어납니다.

ratio?string

비디오 화면 비율입니다. 텍스트 기반 및 멀티모달 참조 기반 생성에서는 비율을 지정하거나 adaptive를 사용할 수 있습니다. 시작 프레임, 시작·종료 프레임, 비디오 편집 및 연장 작업은 adaptive만 지원합니다.

기본값"adaptive"

허용 값

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

duration?|integer

생성 길이이며 단위는 초입니다. 4–30을 지원하며 -1을 전달하면 모델이 자동으로 결정합니다. 비디오 편집은 -1만 지원하고 비디오 연장은 4–30 또는 -1을 지원합니다.

기본값-1

resolution?string

출력 비디오 해상도입니다. 480p, 720p 및 1080p를 지원합니다. 실제 출력 픽셀 크기는 해상도, 화면 비율 및 현재 모델 능력에 따라 결정됩니다.

기본값"720p"

허용 값

"480p"
"720p"
"1080p"

output_format?string

출력 비디오 형식입니다. mp4는 웹과 일반 배포에 적합합니다. mov는 H.264, YUV444P 및 PCM을 사용하며 색 보정, 배경 제거, 합성 등 후반 작업에 적합합니다.

기본값"mp4"

허용 값

"mp4"
"mov"

watermark?boolean

워터마크 추가 여부입니다. 적용 여부는 모델 권한과 서비스 설정에 따라 달라집니다.

seed?integer

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

범위-1 <= value <= 4294967295

return_last_frame?boolean

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

callback_url?string

작업 완료 후 callback 주소입니다. 설정하지 않으면 조회 API로 작업 상태를 폴링할 수 있습니다.

형식uri

safety_identifier?string

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

길이1 <= length <= 64

execution_expires_after?integer

생성 시점부터 계산한 작업 유효 시간이며 단위는 초입니다. 이 시간이 지난 후에도 완료되지 않은 작업은 만료 상태가 됩니다.

형식int32

범위3600 <= value <= 259200

기본값172800

tools?array<>

모델이 호출할 수 있는 도구 목록입니다. 예를 들어 web_search입니다. 사용 가능한 도구와 구체적인 매개변수는 현재 계정 권한에 따라 달라집니다.

service_tier?string

서비스 등급입니다. Seedance 2.5는 default 온라인 추론을 사용하며 flex를 지원하지 않습니다. 대기열 우선순위는 별도 priority 매개변수로 설정합니다.

기본값"default"

priority?integer

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

범위0 <= value <= 9

기본값0

[key: string]?any

응답 본문

`application/json`

curl -X POST "https://example.com/api/v3/contents/generations/tasks" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "content": [
      {
        "type": "text",
        "text": "흰 토끼가 종이비행기를 타고 구름 사이를 지나갑니다. 영화 같은 빛과 그림자, 카메라는 안정적으로 전진합니다"
      }
    ],
    "generate_audio": true,
    "ratio": "16:9",
    "duration": 10,
    "resolution": "1080p",
    "output_format": "mp4"
  }'

{
  "id": "task_xxxxx"
}

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

Seedance 2.5 비디오 생성(네이티브 형식)

인증

요청 본문

응답 본문

200application/json

400

401

402

429

500

502

`application/json`