Kling 4.0 Reference to Video: Models and API의 이미지, 비디오 및 주제 | RunComfy

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/kling/kling-v4/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": ""
  }'

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

{
  "type": "object",
  "title": "입력 스키마",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "title": "프롬프트",
      "description": "샷을 설명하세요. 참조 이미지는 @Image1로, 비디오는 @Video1로, 피사체는 @Element1로 지정합니다.",
      "type": "string",
      "examples": [
        "Use @Image1. She turns from profile toward the camera and gives a small closed-mouth smile. The studio light stays soft. Audio: quiet room tone and a faint cloth rustle, no music."
      ]
    },
    "image_urls": {
      "title": "이미지 URL",
      "description": "참조 이미지(최대 10개)는 목록 순서대로 @Image1로 지정됩니다. 오프닝, 중간 및 끝 프레임은 동일한 10개로 계산됩니다.",
      "type": "array",
      "maxItems": 10,
      "items": {
        "type": "string",
        "format": "image_uri"
      },
      "examples": [
        [
          "https://playgrounds-storage-public.runcomfy.net/tools/7479/media-files/promo-input.webp"
        ]
      ]
    },
    "video_urls": {
      "title": "비디오 URL",
      "description": "@Video1로 주소가 지정된 3~30초당 최대 5개의 참조 비디오입니다. 비디오 피사체와 함께 30초 이내에 유지됩니다.",
      "type": "array",
      "maxItems": 5,
      "items": {
        "type": "string",
        "format": "video_uri"
      }
    },
    "start_image_url": {
      "title": "시작 이미지",
      "description": "선택적인 오프닝 프레임. 총 10개의 이미지에 포함됩니다.",
      "type": "string"
    },
    "middle_image_urls": {
      "title": "중간 이미지",
      "description": "열림과 닫힘 사이에 선택적으로 정렬된 프레임입니다. 최대 8개.",
      "type": "array",
      "maxItems": 8,
      "items": {
        "type": "string",
        "format": "image_uri"
      }
    },
    "end_image_url": {
      "title": "끝 이미지",
      "description": "선택적 마지막 프레임. 총 10개의 이미지에 포함됩니다.",
      "type": "string"
    },
    "elements": {
      "title": "요소",
      "description": "최대 7개의 주제를 저장할 수 있습니다. 각각은 정면도와 선택적 각도 또는 3~8초짜리 단일 동영상입니다. 동영상은 최대 3개까지 가능합니다. @Element1, @Element2 등으로 참조하세요.",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "frontal_image_url": {
            "type": "string",
            "format": "image_uri",
            "description": "대상의 정면 모습. 최대 3개의 추가 각도와 함께 사용하거나 대신 비디오를 사용하세요."
          },
          "reference_image_urls": {
            "type": "array",
            "format": "image_uris",
            "maxItems": 3,
            "items": {
              "type": "string",
              "format": "image_uri"
            },
            "description": "최대 3개의 추가 각도. 정면도가 필요하며 동영상과 결합할 수 없습니다."
          },
          "video_url": {
            "type": "string",
            "format": "video_uri",
            "description": "이미지 대신 사용되는 주제에 대한 3~8초 분량의 클립 1개. 최대 3개의 요소는 동영상일 수 있습니다."
          }
        }
      },
      "minItems": 0,
      "maxItems": 7
    },
    "duration": {
      "title": "길이",
      "description": "전체 초 단위의 클립 길이입니다. 기본값은 5입니다.",
      "type": "integer",
      "minimum": 3,
      "maximum": 30,
      "default": 5
    },
    "resolution": {
      "title": "해상도",
      "description": "출력 해상도. 1080p가 기본값입니다. 720p는 더 가벼운 패스입니다.",
      "type": "string",
      "enum": [
        "720p",
        "1080p"
      ],
      "default": "1080p"
    },
    "aspect_ratio": {
      "title": "화면비",
      "description": "출력 프레임. 자동은 참조를 따릅니다. 16:9가 기본값입니다.",
      "type": "string",
      "enum": [
        "16:9",
        "9:16",
        "1:1",
        "21:9",
        "auto"
      ],
      "default": "16:9"
    }
  }
}