> ## Documentation Index
> Fetch the complete documentation index at: https://docs.toapis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Seedance 2.5 드래프트 모드

> 저렴한 480p 드래프트로 먼저 확인하고, 그 드래프트로 1080p 최종 영상을 생성합니다

<Note>
  **중국 본토 사용자 안내:** 중국 본토 사용자는 `https://toapis.cn` 를 API 엔드포인트(Base URL)로 사용해 주세요. 본 문서의 예시에서 `https://toapis.com` 을 `https://toapis.cn` 로 바꿔 주세요.
</Note>

드래프트 모드는 한 번의 생성을 두 단계로 나눕니다. 먼저 저렴한 480p 드래프트를 생성해 카메라 움직임과 구도를 확인한 뒤, 그 드래프트로 1080p 최종 영상을 생성합니다. 최종 생성에서는 상위 서비스가 드래프트의 프롬프트와 소재를 재사용하므로 두 번째 단계에서 다시 보낼 필요가 없습니다.

두 단계 모두 같은 `seedance-2-5` 모델로 `POST /v1/videos/generations`를 호출합니다.

## 두 단계 흐름

1. `draft: true`를 포함해 드래프트를 제출하고 응답에서 드래프트 작업 ID를 받습니다.
2. 드래프트 완료를 기다린 뒤 [동영상 작업 상태 조회](/docs/ko/api-reference/tasks/video-status)로 `status`가 `completed`인지 확인합니다.
3. `draft_task_id`에 1단계의 작업 ID를 넣어 최종 요청을 제출합니다. 프롬프트와 소재는 다시 보내지 마세요.

## 단계별 비교

| 항목 | 드래프트(`draft: true`) | 최종(`draft_task_id`) |
| - | - | - |
| 지원 모델 | `seedance-2-5` 전용 | `seedance-2-5` 전용 |
| `resolution` | 항상 `480p` | 항상 `1080p` |
| `output_format` | `mp4` | `mp4` 또는 `mov` |
| 프롬프트와 소재 | [일반 생성](./generation)과 동일 | 허용되지 않으며 생략해야 함 |
| 드래프트 작업 상태 | - | 정상 완료 상태여야 함 |
| 드래프트 유효 기간 | - | 생성 후 7일 이내 |
| 과금 | 드래프트 요금 | 드래프트를 동영상 입력으로 처리하여 동영상 입력 요금 적용 |

<Warning>
  최종 요청은 드래프트와 같은 `model`을 사용해야 하며, 드래프트 채널에서 드래프트 기능이 계속 활성화되어 있어야 합니다. 드래프트 작업이 정상 완료되지 않았거나, 생성 후 7일이 지났거나, 모델이 다르거나, 채널 기능이 꺼져 있으면 최종 요청은 `invalid_draft_task`로 실패하며 드래프트를 다시 생성해야 합니다.
</Warning>

## Body

<ParamField body="draft" type="boolean" default={false}>
  `true`로 설정하면 드래프트를 제출합니다. 드래프트는 `480p`로 생성되며 나머지 파라미터는 [일반 생성](./generation)과 동일하게 동작합니다.

  `seedance-2-5`에서만 지원합니다. 다른 모델에서는 `draft mode is only supported for Seedance 2.5`를 반환합니다.
</ParamField>

<ParamField body="draft_task_id" type="string">
  최종 요청에서 필수입니다. 드래프트 응답이 반환한 작업 ID(`tsk_vid_...`)를 넣습니다.

  `draft: true`와 함께 사용할 수 없습니다. `draft_task_id`를 지정하면 `prompt`, `image_urls`, `image_with_roles`, `video_with_roles`, `audio_with_roles`를 보내지 마세요. 보내면 `draft requests cannot include prompt or media`를 반환합니다.
</ParamField>

<ParamField body="resolution" type="string">
  드래프트는 `480p`, 최종은 `1080p`로 고정됩니다. 생략할 수 있으며 생략하면 해당 단계의 고정 값이 사용됩니다. 다른 값을 명시하면 거부됩니다.
</ParamField>

<ParamField body="output_format" type="string" default="mp4">
  최종 요청에서만 지정할 수 있습니다. `mp4`와 `mov`를 지원합니다.
</ParamField>

<ParamField body="return_last_frame" type="boolean" default={false}>
  최종 요청은 드래프트의 마지막 프레임 설정을 상속하지 않습니다. 최종 영상에도 마지막 프레임이 필요하면 최종 요청에서 다시 `true`를 보내세요.
</ParamField>

나머지 파라미터(`prompt`, `duration`, `aspect_ratio`, `generate_audio`, 참조 소재 등)는 드래프트 단계에서도 [Seedance 2.5 동영상 생성](./generation)과 동일하게 사용합니다.

## 요청 예시

아래 두 예시는 드래프트 제출과 그 드래프트로 최종 영상을 생성하는 완전한 요청입니다. 순서대로 실행하세요.

<RequestExample>
  ```bash cURL (드래프트 제출) theme={null}
  curl --request POST \
    --url https://toapis.com/v1/videos/generations \
    --header 'Authorization: Bearer <token>' \
    --header 'Content-Type: application/json' \
    --data '{
      "model": "seedance-2-5",
      "draft": true,
      "prompt": "영화 같은 제품 클로즈업, 카메라가 천천히 전진한다.",
      "duration": 4,
      "resolution": "480p",
      "return_last_frame": true
    }'
  ```

  ```bash cURL (최종 영상 생성) theme={null}
  curl --request POST \
    --url https://toapis.com/v1/videos/generations \
    --header 'Authorization: Bearer <token>' \
    --header 'Content-Type: application/json' \
    --data '{
      "model": "seedance-2-5",
      "draft_task_id": "tsk_vid_xxx",
      "resolution": "1080p",
      "output_format": "mp4",
      "return_last_frame": true
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "tsk_vid_xxx",
    "object": "generation.task",
    "model": "seedance-2-5",
    "status": "in_progress",
    "progress": 10,
    "created_at": 1781577600
  }
  ```
</ResponseExample>

## 과금

드래프트와 최종 영상은 각각 별도로 과금되며 각 작업이 완료될 때 정산됩니다. 드래프트는 드래프트 요금으로 정산됩니다. 최종 요청은 드래프트 영상을 동영상 입력으로 처리하므로 동영상 입력 요금으로 정산되어 단가가 드래프트보다 높습니다. 실제 청구 금액은 작업 결과와 [요금과 실제 비용](/docs/ko/api-reference/account/pricing)을 기준으로 합니다.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.