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