Submit an asynchronous Seedance video generation job. Select version and tier; supported modes, durations and prices depend on the selected version. Seedance 영상 생성 작업을 비동기로 접수합니다. text/image/reference 세 가지 mode를 지원하며, seedance_jobs_status Tool로 상태를 조회하고 완료되면 응답의 result_url(REST 다운로드 주소, 7일 이내 유효)로 다운로드합니다. 접수 시 duration × 초당 포인트(해상도별로 다름, resolution 참고)가 예약 차감되고 완료 시 확정, 실패·시간 초과 시 전액 환불됩니다. [기본 버전 기준: 초당 480p 560P·720p 1,250P·1080p 2,810P × duration(초). 다른 버전은 개발가이드의 버전별 요금표 참고.]
View input schema
{
"type": "object",
"properties": {
"version": {
"type": "string",
"enum": [
"2.5",
"2.0",
"1.5",
"1.0"
],
"description": "영상 모델 버전. 생략 시 2.5. 등급·해상도·길이·오디오·파일 제약과 요금은 선택 버전별 개발가이드 표를 확인하세요."
},
"prompt": {
"type": "string",
"maxLength": 2000,
"description": "영상 생성 프롬프트, 최대 2,000자"
},
"mode": {
"type": "string",
"enum": [
"text",
"image",
"reference"
],
"description": "입력 방식 — 'text'(텍스트만) | 'image'(첫 프레임 이미지 지정) | 'reference'(참조 이미지·영상으로 주체 지정). 기본 text"
},
"duration": {
"type": "integer",
"minimum": 2,
"maximum": 30,
"description": "영상 길이(초), 전체 버전 범위 2~30. 허용 값과 기본값은 버전·등급별로 다릅니다."
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"4:3",
"1:1",
"3:4",
"9:16",
"21:9",
"adaptive"
],
"description": "출력 화면 비율. 선택 버전·등급·모드에서 허용하는 값만 사용하세요."
},
"resolution": {
"type": "string",
"enum": [
"480p",
"720p",
"1080p"
],
"description": "출력 해상도. 전체 버전의 값 목록이며 허용 조합·기본값·요금은 버전별 개발가이드를 따릅니다."
},
"audio": {
"type": "boolean",
"description": "오디오 생성 여부. 선택 가능한 버전은 기본 true, 무음 전용 버전은 false, 오디오 필수 버전은 true만 허용합니다."
},
"tier": {
"type": "string",
"enum": [
"standard",
"fast",
"mini",
"pro"
],
"description": "품질·속도 등급. 지원 등급과 생략 시 기본값은 version과 mode에 따라 다릅니다."
},
"seed": {
"type": "integer",
"minimum": 0,
"maximum": 2147483647,
"description": "재현성을 위한 시드 값"
},
"idempotency_key": {
"type": "string",
"minLength": 8,
"maxLength": 128,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "같은 요청의 재전송으로 인한 중복 접수·과금을 막는 고유 키"
},
"image_url": {
"type": "string",
"description": "image 모드에서 사용할 첫 프레임 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"last_image_url": {
"type": "string",
"description": "image 모드에서 사용할 마지막 프레임 이미지 URL(선택) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url": {
"type": "string",
"description": "reference 모드에서 주체를 지정할 참조 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_2": {
"type": "string",
"description": "reference 모드 참조 이미지 URL(2번째) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_3": {
"type": "string",
"description": "reference 모드 참조 이미지 URL(3번째) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_video_url": {
"type": "string",
"description": "reference 모드에서 동작을 참조할 영상 URL — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 50MB)"
},
"reference_image_url_4": {
"type": "string",
"description": "참조 이미지 URL(4번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_5": {
"type": "string",
"description": "참조 이미지 URL(5번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_6": {
"type": "string",
"description": "참조 이미지 URL(6번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_7": {
"type": "string",
"description": "참조 이미지 URL(7번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_8": {
"type": "string",
"description": "참조 이미지 URL(8번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_9": {
"type": "string",
"description": "참조 이미지 URL(9번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_10": {
"type": "string",
"description": "참조 이미지 URL(10번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_11": {
"type": "string",
"description": "참조 이미지 URL(11번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_12": {
"type": "string",
"description": "참조 이미지 URL(12번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_13": {
"type": "string",
"description": "참조 이미지 URL(13번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_14": {
"type": "string",
"description": "참조 이미지 URL(14번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_15": {
"type": "string",
"description": "참조 이미지 URL(15번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_16": {
"type": "string",
"description": "참조 이미지 URL(16번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_17": {
"type": "string",
"description": "참조 이미지 URL(17번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_18": {
"type": "string",
"description": "참조 이미지 URL(18번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_19": {
"type": "string",
"description": "참조 이미지 URL(19번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_20": {
"type": "string",
"description": "참조 이미지 URL(20번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_21": {
"type": "string",
"description": "참조 이미지 URL(21번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_22": {
"type": "string",
"description": "참조 이미지 URL(22번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_23": {
"type": "string",
"description": "참조 이미지 URL(23번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_24": {
"type": "string",
"description": "참조 이미지 URL(24번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_25": {
"type": "string",
"description": "참조 이미지 URL(25번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_26": {
"type": "string",
"description": "참조 이미지 URL(26번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_27": {
"type": "string",
"description": "참조 이미지 URL(27번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_28": {
"type": "string",
"description": "참조 이미지 URL(28번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_29": {
"type": "string",
"description": "참조 이미지 URL(29번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_30": {
"type": "string",
"description": "참조 이미지 URL(30번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_video_url_2": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
},
"reference_video_url_3": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
},
"reference_video_url_4": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
},
"reference_video_url_5": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
},
"reference_video_url_6": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
},
"reference_video_url_7": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
},
"reference_video_url_8": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
},
"reference_video_url_9": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
},
"reference_video_url_10": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
},
"reference_audio_url": {
"type": "string",
"description": "참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB)"
},
"reference_audio_url_2": {
"type": "string",
"description": "참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB)"
},
"reference_audio_url_3": {
"type": "string",
"description": "참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB)"
},
"reference_audio_url_4": {
"type": "string",
"description": "참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB)"
},
"reference_audio_url_5": {
"type": "string",
"description": "참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB)"
},
"reference_audio_url_6": {
"type": "string",
"description": "참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB)"
},
"reference_audio_url_7": {
"type": "string",
"description": "참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB)"
},
"reference_audio_url_8": {
"type": "string",
"description": "참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB)"
},
"reference_audio_url_9": {
"type": "string",
"description": "참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB)"
},
"reference_audio_url_10": {
"type": "string",
"description": "참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB)"
}
},
"required": [
"prompt"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}