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"
    }
  }
}