> ## 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` 로 바꿔 주세요.

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

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

## 두 단계 흐름

1. `draft: true`를 포함해 드래프트를 제출하고 응답에서 드래프트 작업 ID를 받습니다.
2. 드래프트 완료를 기다린 뒤 [동영상 작업 상태 조회](https://docs.toapis.com/docs/ko/api-reference/tasks/video-status.md)로 `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` |
| 프롬프트와 소재 | [일반 생성](https://docs.toapis.com/docs/ko/api-reference/videos/seedance-2-5/generation.md)과 동일 | 허용되지 않으며 생략해야 함 |
| 드래프트 작업 상태 | - | 정상 완료 상태여야 함 |
| 드래프트 유효 기간 | - | 생성 후 7일 이내 |
| 과금 | 480p 요금 | 1080p 요금. 단가는 드래프트 요청에 동영상 입력이 있었는지에 따라 결정 |

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

## Body

**draft** `boolean` (default: false)

`true`로 설정하면 드래프트를 제출합니다. 드래프트는 `480p`로 생성되며 나머지 파라미터는 [일반 생성](https://docs.toapis.com/docs/ko/api-reference/videos/seedance-2-5/generation.md)과 동일하게 동작합니다.

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

**draft\_task\_id** `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`를 반환합니다.

**resolution** `string`

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

**output\_format** `string` (default: mp4)

최종 요청에서만 지정할 수 있습니다. `mp4`와 `mov`를 지원합니다.

**return\_last\_frame** `boolean` (default: false)

최종 요청은 드래프트의 마지막 프레임 설정을 상속하지 않습니다. 최종 영상에도 마지막 프레임이 필요하면 최종 요청에서 다시 `true`를 보내세요.

나머지 파라미터(`prompt`, `duration`, `aspect_ratio`, `generate_audio`, 참조 소재 등)는 드래프트 단계에서도 [Seedance 2.5 동영상 생성](https://docs.toapis.com/docs/ko/api-reference/videos/seedance-2-5/generation.md)과 동일하게 사용합니다.

## 요청 예시

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

```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
  }'
```

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

## 과금

드래프트와 최종 영상은 각각 별도로 과금되며, 각 작업이 완료될 때 상위 서비스가 보고한 실제 token 사용량으로 정산됩니다. 드래프트는 480p 요금, 최종 영상은 1080p 요금으로 정산됩니다. 최종 요청의 단가는 드래프트 요청에 동영상 입력이 있었는지에 따라 결정됩니다. 드래프트에 참조 동영상이 있었다면 동영상 입력 단가가 적용되고, 입력 동영상 길이는 드래프트의 원래 입력 동영상 기준으로 계산됩니다(드래프트 영상 자체는 입력에 포함되지 않음). 드래프트에 동영상 입력이 없었다면 동영상 입력 없음 단가가 적용됩니다. 실제 청구 금액은 작업 결과와 [요금과 실제 비용](https://docs.toapis.com/docs/ko/api-reference/account/pricing.md)을 기준으로 합니다.


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