Kling O1 视频编辑：提示词与参考内容控制 | RunComfy

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/kling/kling-video-o1/video-to-video/edit \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Replace the character in the video with @Element1, maintaining the same movements and camera angles. Transform the landscape into @Image1",
    "video_url": "https://playgrounds-storage-public.runcomfy.net/tools/7246/media-files/input-1-1.mp4",
    "elements": [
      {
        "frontal_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7246/media-files/input-1-2.png",
        "reference_image_urls": [
          "https://playgrounds-storage-public.runcomfy.net/tools/7246/media-files/input-1-3.jpeg"
        ]
      }
    ],
    "image_urls": [
      "https://playgrounds-storage-public.runcomfy.net/tools/7246/media-files/input-1-4.png"
    ]
  }'

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",
    "video_url",
    "elements",
    "image_urls"
  ],
  "properties": {
    "prompt": {
      "title": "提示词",
      "description": "使用 @Element1、@Element2 等标记按顺序引用元素；使用 @Image1、@Image2 等标记按顺序引用图片。",
      "type": "string",
      "default": "Replace the character in the video with @Element1, maintaining the same movements and camera angles. Transform the landscape into @Image1"
    },
    "video_url": {
      "title": "视频 URL",
      "description": "用于引导动作和场景构图的源视频 URL。支持 .mp4 和 .mov；时长 3–10 秒；输入分辨率 720p–2160p；文件最大 200 MB。",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/tools/7246/media-files/input-1-1.mp4"
    },
    "elements": {
      "title": "元素",
      "description": "要加入的人物或物体。在提示词中按顺序使用 @Element1、@Element2 等标记引用。数组最多接受 7 个元素；视频请求还需遵守参考内容合计数量限制。",
      "type": "array",
      "default": [
        {
          "frontal_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7246/media-files/input-1-2.png",
          "reference_image_urls": [
            "https://playgrounds-storage-public.runcomfy.net/tools/7246/media-files/input-1-3.jpeg"
          ]
        }
      ],
      "items": {
        "frontal_image_url": {
          "title": "正面图片 URL",
          "description": "元素的主要正面图片。文件最大 10.0 MB；宽和高至少 300 × 300 px；宽高比范围 0.40–2.50；超时时间 20.0 秒。",
          "type": "string",
          "format": "image_uri",
          "default": ""
        },
        "reference_image_urls": {
          "title": "参考图 URL",
          "description": "元素的其他角度参考图。需提供 1–4 个参考图 URL，至少 1 个。",
          "type": "array",
          "format": "image_uris",
          "items": {
            "type": "string",
            "format": "image_uri"
          },
          "default": [],
          "maxItems": 4,
          "minItems": 1
        }
      },
      "maxItems": 7,
      "minItems": 0
    },
    "image_urls": {
      "title": "图片",
      "description": "用于引导风格或外观的参考图。在提示词中按顺序使用 @Image1、@Image2 等标记引用。数组最多接受 4 张图片；使用视频时，字段说明要求元素与参考图合计不超过 4 个。",
      "type": "array",
      "items": {
        "type": "string",
        "format": "image_uri"
      },
      "maxItems": 4,
      "minItems": 0,
      "default": [
        "https://playgrounds-storage-public.runcomfy.net/tools/7246/media-files/input-1-4.png"
      ]
    },
    "keep_audio": {
      "title": "保留原始音频",
      "description": "选择输出中是否保留输入视频的原始音轨。",
      "type": "boolean",
      "default": false
    }
  }
}