Kling Kling V3.0 4K Image-to-Video API | 定價與文件

kling/kling-3.0/4k/image-to-video

將參考圖片製作成原生 4K 電影感影片，支援可選首尾影格引導、多段提示詞轉場、身分鎖定參考元素和同步音訊。

1. 快速開始

使用 RunComfy 的 API 執行 kling/kling-3.0/4k/image-to-video。可接受的輸入與輸出請參閱模型的資料結構說明。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/kling/kling-3.0/4k/image-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Bring this still photograph to life in native 4K with hyper-detailed motion. The young American ceramic artist's hands gently cradle and shape the spinning gray clay vessel — the wheel rotates with smooth controlled motion, the soft clay walls rise and slim under her thumbs, a thin glistening ribbon of water trickles continuously down the side, and a few fine droplets of clay-water flick outward in slow motion catching the light. Loose strands of her dirty-blonde hair sway gently, her chest rises and falls with steady calm breathing, eyes stay focused, a small subtle smile tugs at her lips, the linen apron shifts almost imperceptibly. Behind her, dust motes drift through the warm shaft of honey golden-hour light streaming through the multi-pane windows, dried botanicals sway slightly, and faint shadows shift across the whitewashed brick wall as the sun moves. The camera slowly pushes in from a tight medium close-up to an extreme close-up of the wet clay vessel and her glistening fingers, then drifts back up to her face. Ambient sound: the soft whir of the pottery wheel, water droplets, the rustle of linen, distant Portland street ambience, and a warm vinyl indie-folk record playing low. Native-4K hyper-detailed textures — wet clay surface sheen, fingertip ridges, water droplets, hair strands, linen apron weave, brick grain, wood shelf knots — shot on RED Komodo 6K, 50mm anamorphic, shallow depth of field, Kodak Portra color science.",
    "start_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7353/media-files/input.png"
  }'

2. 身分驗證

將 YOUR_API_TOKEN 環境變數設為您的 API 金鑰（在個人資料中管理金鑰），並在每個請求的 Authorization 標頭中以 Bearer 權杖形式攜帶： Authorization: Bearer $YOUR_API_TOKEN。

3. API 參考

提交請求

提交非同步生成工作後，將立即取得 request_id 以及用於查詢狀態、取得結果與取消的 URL。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/kling/kling-3.0/4k/image-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Bring this still photograph to life in native 4K with hyper-detailed motion. The young American ceramic artist's hands gently cradle and shape the spinning gray clay vessel — the wheel rotates with smooth controlled motion, the soft clay walls rise and slim under her thumbs, a thin glistening ribbon of water trickles continuously down the side, and a few fine droplets of clay-water flick outward in slow motion catching the light. Loose strands of her dirty-blonde hair sway gently, her chest rises and falls with steady calm breathing, eyes stay focused, a small subtle smile tugs at her lips, the linen apron shifts almost imperceptibly. Behind her, dust motes drift through the warm shaft of honey golden-hour light streaming through the multi-pane windows, dried botanicals sway slightly, and faint shadows shift across the whitewashed brick wall as the sun moves. The camera slowly pushes in from a tight medium close-up to an extreme close-up of the wet clay vessel and her glistening fingers, then drifts back up to her face. Ambient sound: the soft whir of the pottery wheel, water droplets, the rustle of linen, distant Portland street ambience, and a warm vinyl indie-folk record playing low. Native-4K hyper-detailed textures — wet clay surface sheen, fingertip ridges, water droplets, hair strands, linen apron weave, brick grain, wood shelf knots — shot on RED Komodo 6K, 50mm anamorphic, shallow depth of field, Kodak Portra color science.",
    "start_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7353/media-files/input.png"
  }'

查詢請求狀態

依 request_id 取得目前狀態（「in_queue」、「in_progress」、「completed」或「cancelled」）。

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

取得請求結果

取得指定 request_id 的最終輸出與中繼資料；若工作尚未完成，回應會回傳目前狀態，方便繼續輪詢。

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

取消請求

透過 request_id 取消排隊中的工作；進行中的工作無法取消。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. 檔案輸入

託管檔案（URL）

請提供可公開存取的 HTTPS 位址。確保目標主機允許伺服器端抓取（無需登入或 Cookie）、未被限流或阻擋機器人。建議：圖片 ≤ 50 MB（約 4K），影片 ≤ 100 MB（約 720p 下 2–5 分鐘）。私人資產請使用穩定或預先簽署 URL。

5. 資料結構

輸入結構

{
  "type": "object",
  "title": "輸入結構",
  "required": [
    "prompt",
    "start_image_url"
  ],
  "properties": {
    "prompt": {
      "title": "提示詞",
      "description": "",
      "type": "string",
      "default": "Bring this still photograph to life in native 4K with hyper-detailed motion. The young American ceramic artist's hands gently cradle and shape the spinning gray clay vessel — the wheel rotates with smooth controlled motion, the soft clay walls rise and slim under her thumbs, a thin glistening ribbon of water trickles continuously down the side, and a few fine droplets of clay-water flick outward in slow motion catching the light. Loose strands of her dirty-blonde hair sway gently, her chest rises and falls with steady calm breathing, eyes stay focused, a small subtle smile tugs at her lips, the linen apron shifts almost imperceptibly. Behind her, dust motes drift through the warm shaft of honey golden-hour light streaming through the multi-pane windows, dried botanicals sway slightly, and faint shadows shift across the whitewashed brick wall as the sun moves. The camera slowly pushes in from a tight medium close-up to an extreme close-up of the wet clay vessel and her glistening fingers, then drifts back up to her face. Ambient sound: the soft whir of the pottery wheel, water droplets, the rustle of linen, distant Portland street ambience, and a warm vinyl indie-folk record playing low. Native-4K hyper-detailed textures — wet clay surface sheen, fingertip ridges, water droplets, hair strands, linen apron weave, brick grain, wood shelf knots — shot on RED Komodo 6K, 50mm anamorphic, shallow depth of field, Kodak Portra color science."
    },
    "multi_prompt": {
      "title": "多段提示詞",
      "description": "提供多個提示詞片段來控制場景轉場。所有片段的長度之和必須等於影片總長度。",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "prompt": {
            "type": "string",
            "format": "str"
          },
          "duration": {
            "type": "integer",
            "format": "int_slider_with_range",
            "minimum": 3,
            "maximum": 15,
            "default": 5
          }
        }
      },
      "maxItems": 20,
      "minItems": 0
    },
    "start_image_url": {
      "title": "起始圖片",
      "description": "影片的起始畫面。支援 jpg、jpeg、png、bmp、webp 格式。",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/tools/7353/media-files/input.png"
    },
    "end_image_url": {
      "title": "結束圖片",
      "description": "選填的結束畫面，用於精確控制兩個畫面之間的轉場。支援 jpg、jpeg、png、bmp、webp 格式。",
      "type": "string"
    },
    "duration": {
      "title": "長度",
      "description": "生成影片的總長度，單位為秒。",
      "type": "integer",
      "minimum": 3,
      "maximum": 15,
      "default": 10
    },
    "generate_audio": {
      "title": "生成音訊",
      "description": "啟用後將為影片生成音訊。",
      "type": "boolean",
      "default": true
    },
    "elements": {
      "title": "參考元素",
      "description": "用於生成的素材，包括參考圖片和影片片段。",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "frontal_image_url": {
            "type": "string",
            "format": "image_uri",
            "description": "主體的正面參考圖片。"
          },
          "reference_image_urls": {
            "type": "array",
            "format": "image_uris",
            "items": {
              "type": "string",
              "format": "image_uri"
            },
            "description": "用於引導畫面生成的其他參考圖片網址。"
          },
          "video_url": {
            "type": "string",
            "format": "video_uri",
            "description": "選填的原始影片，用作動作參考。"
          }
        }
      },
      "minItems": 0,
      "maxItems": 3
    },
    "shot_type": {
      "title": "鏡頭模式",
      "description": "定義鏡頭處理或場景取景方式。",
      "type": "string",
      "enum": [
        "customize"
      ],
      "default": "customize"
    },
    "negative_prompt": {
      "title": "負面提示詞",
      "description": "",
      "type": "string"
    },
    "cfg_scale": {
      "title": "引導強度",
      "description": "無分類器引導（CFG）強度，用於控制結果遵循提示詞的程度。",
      "type": "float",
      "minimum": 0,
      "maximum": 1,
      "default": 0.5
    }
  }
}

輸出結構

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "單張圖片 URL"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "單一影片 URL"
      },
      "images": {
        "type": "array",
        "description": "多張圖片 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "多個影片 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}

RunComfy

RunComfy 是首選的 ComfyUI 平台，提供 ComfyUI 在線環境和服務，以及 ComfyUI 工作流程具有驚豔的視覺效果。 RunComfy還提供 AI Models, 幫助藝術家利用最新的AI工具創作出令人驚艷的藝術作品。

1. 快速開始

使用 RunComfy 的 API 執行 kling/kling-3.0/4k/image-to-video。可接受的輸入與輸出請參閱模型的資料結構說明。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/kling/kling-3.0/4k/image-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Bring this still photograph to life in native 4K with hyper-detailed motion. The young American ceramic artist's hands gently cradle and shape the spinning gray clay vessel — the wheel rotates with smooth controlled motion, the soft clay walls rise and slim under her thumbs, a thin glistening ribbon of water trickles continuously down the side, and a few fine droplets of clay-water flick outward in slow motion catching the light. Loose strands of her dirty-blonde hair sway gently, her chest rises and falls with steady calm breathing, eyes stay focused, a small subtle smile tugs at her lips, the linen apron shifts almost imperceptibly. Behind her, dust motes drift through the warm shaft of honey golden-hour light streaming through the multi-pane windows, dried botanicals sway slightly, and faint shadows shift across the whitewashed brick wall as the sun moves. The camera slowly pushes in from a tight medium close-up to an extreme close-up of the wet clay vessel and her glistening fingers, then drifts back up to her face. Ambient sound: the soft whir of the pottery wheel, water droplets, the rustle of linen, distant Portland street ambience, and a warm vinyl indie-folk record playing low. Native-4K hyper-detailed textures — wet clay surface sheen, fingertip ridges, water droplets, hair strands, linen apron weave, brick grain, wood shelf knots — shot on RED Komodo 6K, 50mm anamorphic, shallow depth of field, Kodak Portra color science.",
    "start_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7353/media-files/input.png"
  }'

3. API 參考

提交請求

提交非同步生成工作後，將立即取得 request_id 以及用於查詢狀態、取得結果與取消的 URL。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/kling/kling-3.0/4k/image-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Bring this still photograph to life in native 4K with hyper-detailed motion. The young American ceramic artist's hands gently cradle and shape the spinning gray clay vessel — the wheel rotates with smooth controlled motion, the soft clay walls rise and slim under her thumbs, a thin glistening ribbon of water trickles continuously down the side, and a few fine droplets of clay-water flick outward in slow motion catching the light. Loose strands of her dirty-blonde hair sway gently, her chest rises and falls with steady calm breathing, eyes stay focused, a small subtle smile tugs at her lips, the linen apron shifts almost imperceptibly. Behind her, dust motes drift through the warm shaft of honey golden-hour light streaming through the multi-pane windows, dried botanicals sway slightly, and faint shadows shift across the whitewashed brick wall as the sun moves. The camera slowly pushes in from a tight medium close-up to an extreme close-up of the wet clay vessel and her glistening fingers, then drifts back up to her face. Ambient sound: the soft whir of the pottery wheel, water droplets, the rustle of linen, distant Portland street ambience, and a warm vinyl indie-folk record playing low. Native-4K hyper-detailed textures — wet clay surface sheen, fingertip ridges, water droplets, hair strands, linen apron weave, brick grain, wood shelf knots — shot on RED Komodo 6K, 50mm anamorphic, shallow depth of field, Kodak Portra color science.",
    "start_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7353/media-files/input.png"
  }'

查詢請求狀態

依 request_id 取得目前狀態（「in_queue」、「in_progress」、「completed」或「cancelled」）。

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

取得請求結果

取得指定 request_id 的最終輸出與中繼資料；若工作尚未完成，回應會回傳目前狀態，方便繼續輪詢。

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

取消請求

透過 request_id 取消排隊中的工作；進行中的工作無法取消。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. 檔案輸入

託管檔案（URL）

5. 資料結構

輸入結構

{
  "type": "object",
  "title": "輸入結構",
  "required": [
    "prompt",
    "start_image_url"
  ],
  "properties": {
    "prompt": {
      "title": "提示詞",
      "description": "",
      "type": "string",
      "default": "Bring this still photograph to life in native 4K with hyper-detailed motion. The young American ceramic artist's hands gently cradle and shape the spinning gray clay vessel — the wheel rotates with smooth controlled motion, the soft clay walls rise and slim under her thumbs, a thin glistening ribbon of water trickles continuously down the side, and a few fine droplets of clay-water flick outward in slow motion catching the light. Loose strands of her dirty-blonde hair sway gently, her chest rises and falls with steady calm breathing, eyes stay focused, a small subtle smile tugs at her lips, the linen apron shifts almost imperceptibly. Behind her, dust motes drift through the warm shaft of honey golden-hour light streaming through the multi-pane windows, dried botanicals sway slightly, and faint shadows shift across the whitewashed brick wall as the sun moves. The camera slowly pushes in from a tight medium close-up to an extreme close-up of the wet clay vessel and her glistening fingers, then drifts back up to her face. Ambient sound: the soft whir of the pottery wheel, water droplets, the rustle of linen, distant Portland street ambience, and a warm vinyl indie-folk record playing low. Native-4K hyper-detailed textures — wet clay surface sheen, fingertip ridges, water droplets, hair strands, linen apron weave, brick grain, wood shelf knots — shot on RED Komodo 6K, 50mm anamorphic, shallow depth of field, Kodak Portra color science."
    },
    "multi_prompt": {
      "title": "多段提示詞",
      "description": "提供多個提示詞片段來控制場景轉場。所有片段的長度之和必須等於影片總長度。",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "prompt": {
            "type": "string",
            "format": "str"
          },
          "duration": {
            "type": "integer",
            "format": "int_slider_with_range",
            "minimum": 3,
            "maximum": 15,
            "default": 5
          }
        }
      },
      "maxItems": 20,
      "minItems": 0
    },
    "start_image_url": {
      "title": "起始圖片",
      "description": "影片的起始畫面。支援 jpg、jpeg、png、bmp、webp 格式。",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/tools/7353/media-files/input.png"
    },
    "end_image_url": {
      "title": "結束圖片",
      "description": "選填的結束畫面，用於精確控制兩個畫面之間的轉場。支援 jpg、jpeg、png、bmp、webp 格式。",
      "type": "string"
    },
    "duration": {
      "title": "長度",
      "description": "生成影片的總長度，單位為秒。",
      "type": "integer",
      "minimum": 3,
      "maximum": 15,
      "default": 10
    },
    "generate_audio": {
      "title": "生成音訊",
      "description": "啟用後將為影片生成音訊。",
      "type": "boolean",
      "default": true
    },
    "elements": {
      "title": "參考元素",
      "description": "用於生成的素材，包括參考圖片和影片片段。",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "frontal_image_url": {
            "type": "string",
            "format": "image_uri",
            "description": "主體的正面參考圖片。"
          },
          "reference_image_urls": {
            "type": "array",
            "format": "image_uris",
            "items": {
              "type": "string",
              "format": "image_uri"
            },
            "description": "用於引導畫面生成的其他參考圖片網址。"
          },
          "video_url": {
            "type": "string",
            "format": "video_uri",
            "description": "選填的原始影片，用作動作參考。"
          }
        }
      },
      "minItems": 0,
      "maxItems": 3
    },
    "shot_type": {
      "title": "鏡頭模式",
      "description": "定義鏡頭處理或場景取景方式。",
      "type": "string",
      "enum": [
        "customize"
      ],
      "default": "customize"
    },
    "negative_prompt": {
      "title": "負面提示詞",
      "description": "",
      "type": "string"
    },
    "cfg_scale": {
      "title": "引導強度",
      "description": "無分類器引導（CFG）強度，用於控制結果遵循提示詞的程度。",
      "type": "float",
      "minimum": 0,
      "maximum": 1,
      "default": 0.5
    }
  }
}

輸出結構

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "單張圖片 URL"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "單一影片 URL"
      },
      "images": {
        "type": "array",
        "description": "多張圖片 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "多個影片 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}

將參考圖片製作成原生 4K 電影感影片，支援可選首尾影格引導、多段提示詞轉場、身分鎖定參考元素和同步音訊。

目錄

1. 快速開始

2. 身分驗證

3. API 參考

提交請求

查詢請求狀態

取得請求結果

取消請求

4. 檔案輸入

託管檔案（URL）

5. 資料結構

輸入結構

輸出結構

將參考圖片製作成原生 4K 電影感影片，支援可選首尾影格引導、多段提示詞轉場、身分鎖定參考元素和同步音訊。

目錄

1. 快速開始

2. 身分驗證

3. API 參考

提交請求

查詢請求狀態

取得請求結果

取消請求

4. 檔案輸入

託管檔案（URL）

5. 資料結構

輸入結構

輸出結構

Kling V3.0 4K Image-to-Video：在模型頁面與 API 上生成原生 4K 圖片動畫 | RunComfy

將參考圖片製作成原生 4K 電影感影片，支援可選首尾影格引導、多段提示詞轉場、身分鎖定參考元素和同步音訊。

目錄

1. 快速開始

2. 身分驗證

3. API 參考

提交請求

查詢請求狀態

取得請求結果

取消請求

4. 檔案輸入

託管檔案（URL）

5. 資料結構

輸入結構

輸出結構

Kling V3.0 4K Image-to-Video：在模型頁面與 API 上生成原生 4K 圖片動畫 | RunComfy

將參考圖片製作成原生 4K 電影感影片，支援可選首尾影格引導、多段提示詞轉場、身分鎖定參考元素和同步音訊。

目錄

1. 快速開始

2. 身分驗證

3. API 參考

提交請求

查詢請求狀態

取得請求結果

取消請求

4. 檔案輸入

託管檔案（URL）

5. 資料結構

輸入結構

輸出結構