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
}'
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
}'
{
"id": "tsk_vid_xxx",
"object": "generation.task",
"model": "seedance-2-5",
"status": "in_progress",
"progress": 10,
"created_at": 1781577600
}
seedance-2-5
Seedance 2.5 드래프트 모드
저렴한 480p 드래프트로 먼저 확인하고, 그 드래프트로 1080p 최종 영상을 생성합니다
POST
/
v1
/
videos
/
generations
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
}'
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
}'
{
"id": "tsk_vid_xxx",
"object": "generation.task",
"model": "seedance-2-5",
"status": "in_progress",
"progress": 10,
"created_at": 1781577600
}
중국 본토 사용자 안내: 중국 본토 사용자는
https://toapis.cn 를 API 엔드포인트(Base URL)로 사용해 주세요. 본 문서의 예시에서 https://toapis.com 을 https://toapis.cn 로 바꿔 주세요.seedance-2-5 모델로 POST /v1/videos/generations를 호출합니다.
두 단계 흐름
draft: true를 포함해 드래프트를 제출하고 응답에서 드래프트 작업 ID를 받습니다.- 드래프트 완료를 기다린 뒤 동영상 작업 상태 조회로
status가completed인지 확인합니다. draft_task_id에 1단계의 작업 ID를 넣어 최종 요청을 제출합니다. 프롬프트와 소재는 다시 보내지 마세요.
단계별 비교
| 항목 | 드래프트(draft: true) | 최종(draft_task_id) |
|---|---|---|
| 지원 모델 | seedance-2-5 전용 | seedance-2-5 전용 |
resolution | 항상 480p | 항상 1080p |
output_format | mp4 | mp4 또는 mov |
| 프롬프트와 소재 | 일반 생성과 동일 | 허용되지 않으며 생략해야 함 |
| 드래프트 작업 상태 | - | 정상 완료 상태여야 함 |
| 드래프트 유효 기간 | - | 생성 후 7일 이내 |
| 과금 | 드래프트 요금 | 드래프트를 동영상 입력으로 처리하여 동영상 입력 요금 적용 |
최종 요청은 드래프트와 같은
model을 사용해야 하며, 드래프트 채널에서 드래프트 기능이 계속 활성화되어 있어야 합니다. 드래프트 작업이 정상 완료되지 않았거나, 생성 후 7일이 지났거나, 모델이 다르거나, 채널 기능이 꺼져 있으면 최종 요청은 invalid_draft_task로 실패하며 드래프트를 다시 생성해야 합니다.Body
boolean
기본값:false
true로 설정하면 드래프트를 제출합니다. 드래프트는 480p로 생성되며 나머지 파라미터는 일반 생성과 동일하게 동작합니다.seedance-2-5에서만 지원합니다. 다른 모델에서는 draft mode is only supported for Seedance 2.5를 반환합니다.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를 반환합니다.string
드래프트는
480p, 최종은 1080p로 고정됩니다. 생략할 수 있으며 생략하면 해당 단계의 고정 값이 사용됩니다. 다른 값을 명시하면 거부됩니다.string
기본값:"mp4"
최종 요청에서만 지정할 수 있습니다.
mp4와 mov를 지원합니다.boolean
기본값:false
최종 요청은 드래프트의 마지막 프레임 설정을 상속하지 않습니다. 최종 영상에도 마지막 프레임이 필요하면 최종 요청에서 다시
true를 보내세요.prompt, duration, aspect_ratio, generate_audio, 참조 소재 등)는 드래프트 단계에서도 Seedance 2.5 동영상 생성과 동일하게 사용합니다.
요청 예시
아래 두 예시는 드래프트 제출과 그 드래프트로 최종 영상을 생성하는 완전한 요청입니다. 순서대로 실행하세요.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
}'
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
}'
{
"id": "tsk_vid_xxx",
"object": "generation.task",
"model": "seedance-2-5",
"status": "in_progress",
"progress": 10,
"created_at": 1781577600
}