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": "參考影像，最多十個，依列表順序尋址為 @Image1。 開頭、中間和結尾幀都計入相同的十幀。",
      "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": "參考視頻，最多五個，每個 3-30 秒，地址為 @Video1。 與影片主題一起，它們的停留時間不超過 30 秒。",
      "type": "array",
      "maxItems": 5,
      "items": {
        "type": "string",
        "format": "video_uri"
      }
    },
    "start_image_url": {
      "title": "起始圖片",
      "description": "可選配開口框架。 計入十張圖像總數。",
      "type": "string"
    },
    "middle_image_urls": {
      "title": "中間圖片",
      "description": "打開和關閉之間可選的有序框架。 最多八個。",
      "type": "array",
      "maxItems": 8,
      "items": {
        "type": "string",
        "format": "image_uri"
      }
    },
    "end_image_url": {
      "title": "結束圖片",
      "description": "可選的最後一幀。 計入十張圖像總數。",
      "type": "string"
    },
    "elements": {
      "title": "主體",
      "description": "最多可保存七個科目。 每個都是一個前視圖加上可選角度，或一個 3-8 秒的影片。 最多三個可能是影片。 將它們稱為 @Element1、@Element2 等。",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "frontal_image_url": {
            "type": "string",
            "format": "image_uri",
            "description": "主体的前视图。 使用最多三個額外角度，或使用影片代替。"
          },
          "reference_image_urls": {
            "type": "array",
            "format": "image_uris",
            "maxItems": 3,
            "items": {
              "type": "string",
              "format": "image_uri"
            },
            "description": "最多三個額外角度。 需要前視圖，並且不能與視訊結合。"
          },
          "video_url": {
            "type": "string",
            "format": "video_uri",
            "description": "使用一段 3-8 秒的主體剪輯來取代影像。 至多三個元素可以是影片。"
          }
        }
      },
      "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": "输出帧。 auto 遵循參考文獻。 默认为 16:9。",
      "type": "string",
      "enum": [
        "16:9",
        "9:16",
        "1:1",
        "21:9",
        "auto"
      ],
      "default": "16:9"
    }
  }
}