Seedance 2.5 Draft 샘플 영상 생성 가이드

480p 샘플을 확인한 뒤 Draft 작업 ID로 1080p 최종 영상을 생성합니다.

Draft 샘플 모드로 장면, 카메라 움직임과 피사체 동작을 먼저 확인한 후 최종 영상을 생성할 수 있습니다. 기존 생성 및 조회 API를 사용하여 480p 샘플을 생성하고, 결과를 확인한 후 샘플 작업 ID를 참조해 1080p 최종 영상을 생성합니다.

호출 절차

형식을 선택하고 다음 네 단계를 진행하세요. MODEL_ID를 현재 API Key로 사용할 수 있는 Seedance 2.5 모델로 바꾸고, Key 및 작업 ID 자리표시자를 실제 값으로 바꾸세요. 두 생성 요청은 동일한 모델과 계정을 사용해야 합니다.

Draft 샘플 생성

플랫폼 생성 API에 프롬프트나 참조 자료를 전달하고 draft: true, resolution: "480p"를 설정합니다. 반환된 task_id(id와 같은 의미)를 PLATFORM_DRAFT_TASK_ID로 저장해 샘플 조회에 사용합니다.

curl 'https://api.agtcloud.cn/v1/video/generations' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "MODEL_ID",
    "content": [
      {"type": "text", "text": "작은 흰 토끼가 종이비행기를 타고 구름 사이를 지나며 카메라가 부드럽게 앞으로 이동한다"}
    ],
    "draft": true,
    "resolution": "480p",
    "duration": 5,
    "ratio": "16:9"
  }'

샘플 조회 및 확인

플랫폼 작업 ID로 조회하고 raw=true로 원시 작업 데이터를 읽습니다. status가 queued/running이면 기다린 뒤 다시 조회합니다. 성공하면 content.video_url로 미리 보고 원시 응답의 id를 DRAFT_TASK_ID로 저장합니다.

curl 'https://api.agtcloud.cn/v1/video/generations/PLATFORM_DRAFT_TASK_ID?raw=true' \
  -H 'Authorization: Bearer your-api-key'

두 번째 단계에서는 원시 샘플 ID인 DRAFT_TASK_ID를 사용합니다. 플랫폼 조회용 ID를 원시 샘플 ID와 혼동하지 마세요. 작업이 실패, 취소 또는 만료되면 폴링을 중지하고 오류를 확인하세요. succeeded 상태의 샘플만 다음 단계로 진행할 수 있습니다.

샘플 기반 최종 영상 생성

샘플이 요구에 맞으면 동일한 MODEL_ID를 사용해 content.draft_task.id로 원시 샘플 ID를 참조합니다. 해상도는 반드시 1080p여야 하며, 프롬프트, 자료, 길이 등 자동 상속되는 매개변수를 다시 전달하지 마세요.

curl 'https://api.agtcloud.cn/v1/video/generations' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "MODEL_ID",
    "content": [
      {"type": "draft_task", "draft_task": {"id": "DRAFT_TASK_ID"}}
    ],
    "resolution": "1080p"
  }'

이번에 반환된 새 플랫폼 작업 ID를 PLATFORM_FINAL_TASK_ID로 저장합니다. 샘플 작업 ID와는 서로 다른 작업을 식별합니다.

최종 영상 조회 및 저장

새 작업 ID로 조회한 후 성공하면 원시 응답의 content.video_url에서 최종 영상을 다운로드합니다. draft는 false이며 draft_task_id는 사용한 샘플을 가리킵니다.

curl 'https://api.agtcloud.cn/v1/video/generations/PLATFORM_FINAL_TASK_ID?raw=true' \
  -H 'Authorization: Bearer your-api-key'

raw=true 없이 기본 플랫폼 응답 래퍼를 사용하면 플랫폼 형식 조회 API에 따라 data.status와 결과 URL을 읽으세요. 원시 응답의 필드 경로를 그대로 사용하지 마세요.

최종 생성 매개변수 규칙

매개변수 구분	필드	최종 생성 시 처리
고정 요구사항	`model`, `content.draft_task.id`, `resolution`, `draft`	동일한 모델과 성공한 원시 샘플 ID 사용. 해상도는 `1080p`, `draft`는 생략하거나 `false`
자동 상속	프롬프트, 이미지/영상/오디오 자료, `duration`, `ratio`, `seed`, `generate_audio`, `omni_reference_task_type`	다시 전달하지 마세요. 샘플 단계와 값이 같아도 오류가 발생합니다
다시 설정 가능	`return_last_frame`, `output_format`, `watermark`, `service_tier`, `execution_expires_after`, `priority`, `callback_url`, `safety_identifier`	최종 영상 요구에 맞게 설정합니다. 생략 시 현재 요청의 기본값을 사용하며 샘플 설정의 상속은 보장되지 않습니다

유효기간 및 요금

Draft 작업 ID는 created_at부터 7일 동안 유효합니다. 만료 후에는 최종 영상 생성에 사용할 수 없습니다.
샘플과 최종 영상은 별도의 생성 작업으로 각각 과금됩니다. 샘플은 480p 생성 기준, 최종 영상은 대상 해상도와 입력 조건에 따라 과금됩니다.
결과 영상 URL은 24시간 동안 유효하며 최대 100회 다운로드할 수 있습니다. 즉시 다운로드하거나 별도로 저장하세요.
이 가이드는 Seedance 2.5에 적용되며 Seedance 2.0에는 적용되지 않습니다.

전체 필드는 플랫폼 생성, 네이티브 생성, 플랫폼 조회, 네이티브 조회를 참조하세요.

Seedance 2.5 공식 Draft 가이드샘플 모드의 매개변수 상속, 생성 제한 및 호출 절차를 확인하세요.