kling_jobs_create

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "version": {
      "type": "string",
      "enum": [
        "3.0",
        "o3",
        "o1",
        "2.6",
        "2.5",
        "2.1",
        "2.0",
        "1.6"
      ],
      "description": "영상 모델 버전. 생략 시 3.0. 등급·해상도·길이·오디오·파일 제약과 요금은 선택 버전별 개발가이드 표를 확인하세요."
    },
    "prompt": {
      "type": "string",
      "maxLength": 2000,
      "description": "영상 생성 프롬프트, 최대 2,000자"
    },
    "mode": {
      "type": "string",
      "enum": [
        "text",
        "image",
        "reference"
      ],
      "description": "입력 방식 — 'text'(텍스트만) | 'image'(첫 프레임 이미지 지정) | 'reference'(참조 이미지·영상으로 주체 지정). 기본 text"
    },
    "duration": {
      "type": "integer",
      "minimum": 3,
      "maximum": 15,
      "description": "영상 길이(초), 전체 버전 범위 3~15. 허용 값과 기본값은 버전·등급별로 다릅니다."
    },
    "aspect_ratio": {
      "type": "string",
      "enum": [
        "16:9",
        "9:16",
        "1:1"
      ],
      "description": "출력 화면 비율. 선택 버전·등급·모드에서 허용하는 값만 사용하세요."
    },
    "resolution": {
      "type": "string",
      "enum": [
        "720p",
        "1080p",
        "720P",
        "1080P-SR",
        "1440P-SR",
        "1080P"
      ],
      "description": "출력 해상도. 전체 버전의 값 목록이며 허용 조합·기본값·요금은 버전별 개발가이드를 따릅니다."
    },
    "audio": {
      "type": "boolean",
      "description": "오디오 생성 여부. 선택 가능한 버전은 기본 true, 무음 전용 버전은 false, 오디오 필수 버전은 true만 허용합니다."
    },
    "tier": {
      "type": "string",
      "enum": [
        "std",
        "pro",
        "turbo",
        "4k",
        "standard",
        "master"
      ],
      "description": "품질·속도 등급. 지원 등급과 생략 시 기본값은 version과 mode에 따라 다릅니다."
    },
    "negative_prompt": {
      "type": "string",
      "maxLength": 1000,
      "description": "제외할 요소를 설명하는 텍스트"
    },
    "cfg_scale": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "description": "프롬프트 반영 강도(0~1), 기본 0.5"
    },
    "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) (최대 10MB)"
    },
    "last_image_url": {
      "type": "string",
      "description": "image 모드에서 사용할 마지막 프레임 이미지 URL(선택) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB)"
    },
    "reference_image_url": {
      "type": "string",
      "description": "reference 모드에서 주체를 지정할 참조 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB)"
    },
    "reference_image_url_2": {
      "type": "string",
      "description": "reference 모드 참조 이미지 URL(2번째) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB)"
    },
    "reference_image_url_3": {
      "type": "string",
      "description": "reference 모드 참조 이미지 URL(3번째) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB)"
    },
    "reference_image_url_4": {
      "type": "string",
      "description": "참조 이미지 URL(4번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB)"
    },
    "reference_image_url_5": {
      "type": "string",
      "description": "참조 이미지 URL(5번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB)"
    },
    "reference_image_url_6": {
      "type": "string",
      "description": "참조 이미지 URL(6번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB)"
    },
    "reference_image_url_7": {
      "type": "string",
      "description": "참조 이미지 URL(7번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB)"
    },
    "reference_video_url": {
      "type": "string",
      "description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
    },
    "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)"
    }
  },
  "required": [
    "prompt"
  ]
}