Kling Video O3 Pro Reference To Video: 모델 페이지와 API에서 정체성을 유지하는 영화 같은 영상 생성 | RunComfy

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/kling/kling-video-o3/pro/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "The woman in Figure 1 and the man in Figure 2 walk together along a rain-slick Tokyo street at night, slow cinematic tracking shot, neon reflections, shallow depth of field, photoreal detail."
  }'

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": "장면, 동작, 카메라를 설명하세요. 참조 자료는 위치로 지칭하세요. 예: “Figure 1의 여성이 Figure 2의 남성과 네온이 비치는 골목을 걷는다.”",
      "type": "string",
      "default": "The woman in Figure 1 and the man in Figure 2 walk together along a rain-slick Tokyo street at night, slow cinematic tracking shot, neon reflections, shallow depth of field, photoreal detail."
    },
    "video": {
      "title": "참조 영상 URL",
      "description": "움직임 가이드, 스타일 전환 또는 장면 연속성에 사용할 선택 입력입니다. 지정하면 참조 영상 포함 요금제로 전환되며 오디오 추가 요율보다 우선 적용됩니다.",
      "type": "string"
    },
    "images": {
      "title": "참조 이미지",
      "description": "캐릭터, 소품 또는 스타일의 참조 이미지입니다. 참조 영상이 없으면 최대 7장, 참조 영상이 있으면 최대 4장까지 사용할 수 있습니다.",
      "type": "array",
      "default": [
        "https://playgrounds-storage-public.runcomfy.net/tools/7365/media-files/input-figure1.webp",
        "https://playgrounds-storage-public.runcomfy.net/tools/7365/media-files/input-figure2.webp"
      ],
      "maxItems": 7,
      "minItems": 0
    },
    "keep_original_sound": {
      "title": "원본 오디오 유지",
      "description": "참조 영상을 지정했을 때 해당 영상의 원본 오디오 트랙을 생성 결과에 유지합니다. 기본값: 활성화.",
      "type": "boolean",
      "default": true
    },
    "sound": {
      "title": "오디오 생성",
      "description": "활성화하면 참조 영상이 없을 때만 내용에 맞는 주변음과 효과음을 생성합니다. 1초당 비용이 약 20% 추가됩니다. 기본값: 비활성화.",
      "type": "boolean",
      "default": false
    },
    "aspect_ratio": {
      "title": "화면비(가로:세로)",
      "description": "출력 프레임 비율입니다. 가로형은 16:9, 세로형 소셜 미디어는 9:16, 정사각형은 1:1입니다. 기본값: 16:9.",
      "type": "string",
      "enum": [
        "16:9",
        "9:16",
        "1:1"
      ],
      "default": "16:9"
    },
    "duration": {
      "title": "길이(초)",
      "description": "생성할 영상 길이(3~15초)입니다. 기본값: 5초.",
      "type": "integer",
      "minimum": 3,
      "maximum": 15,
      "default": 5
    },
    "shot_type": {
      "title": "샷 유형",
      "description": "편집 범위입니다. 속도와 컷을 자동으로 결정하려면 intelligent를, 프롬프트로 직접 제어하려면 customize를 사용합니다. 기본값: intelligent.",
      "type": "string",
      "enum": [
        "intelligent",
        "customize"
      ],
      "default": "customize"
    },
    "multi_prompt": {
      "title": "멀티 프롬프트",
      "description": "장면 전환과 전개를 안내하는 추가 프롬프트 구간입니다. multi_prompt 안의 각 구간 길이 합은 전체 영상 길이와 같아야 합니다.",
      "type": "array",
      "items": {
        "prompt": {
          "title": "구간 프롬프트",
          "description": "장면 전환이나 전개를 안내하는 추가 프롬프트 구간입니다.",
          "type": "string",
          "format": "str"
        },
        "duration": {
          "title": "구간 길이(초)",
          "description": "이 프롬프트 구간의 길이(초)입니다.",
          "type": "integer",
          "format": "int_slider_with_range",
          "minimum": 3,
          "maximum": 15,
          "default": 5
        }
      },
      "maxItems": 20,
      "minItems": 0
    }
  }
}