Kling Kling 3.0 Standard Image to Video API | 定價與文件

kling/kling-3.0/standard/image-to-video

透過物理感知運動、攝影機控制和原生音訊將靜態影像動畫化為高保真視頻，以實現快速、電影般的品牌視覺故事敘述。

1. 快速開始

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

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/kling/kling-3.0/standard/image-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Bring this still photograph to life with cinematic motion. The young American woman in a flowing white linen sundress stands on a sunlit Pacific Coast cliff at golden hour: her chestnut hair drifts gently in the ocean breeze, the hem of her dress flutters, and she turns her head and breaks into a soft smile as warm sunlight catches her freckles. Behind her, foamy turquoise waves roll and crash against the rocks below, seabirds glide past, and tall coastal grass sways. The camera slowly dollies in from a wide shot to a tender medium close-up, a subtle parallax revealing the depth of the cliffside. Natural ambient sound: gentle Pacific surf, distant gulls, a soft breeze through the grass, faint acoustic guitar in the background. Photoreal skin and fabric textures, hair strand detail, realistic water physics, golden-hour rim lighting, lens flare, shot on Arri Alexa 35, 50mm anamorphic, shallow depth of field, premium cinematic color grade.",
    "start_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7349/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/standard/image-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Bring this still photograph to life with cinematic motion. The young American woman in a flowing white linen sundress stands on a sunlit Pacific Coast cliff at golden hour: her chestnut hair drifts gently in the ocean breeze, the hem of her dress flutters, and she turns her head and breaks into a soft smile as warm sunlight catches her freckles. Behind her, foamy turquoise waves roll and crash against the rocks below, seabirds glide past, and tall coastal grass sways. The camera slowly dollies in from a wide shot to a tender medium close-up, a subtle parallax revealing the depth of the cliffside. Natural ambient sound: gentle Pacific surf, distant gulls, a soft breeze through the grass, faint acoustic guitar in the background. Photoreal skin and fabric textures, hair strand detail, realistic water physics, golden-hour rim lighting, lens flare, shot on Arri Alexa 35, 50mm anamorphic, shallow depth of field, premium cinematic color grade.",
    "start_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7349/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 with cinematic motion. The young American woman in a flowing white linen sundress stands on a sunlit Pacific Coast cliff at golden hour: her chestnut hair drifts gently in the ocean breeze, the hem of her dress flutters, and she turns her head and breaks into a soft smile as warm sunlight catches her freckles. Behind her, foamy turquoise waves roll and crash against the rocks below, seabirds glide past, and tall coastal grass sways. The camera slowly dollies in from a wide shot to a tender medium close-up, a subtle parallax revealing the depth of the cliffside. Natural ambient sound: gentle Pacific surf, distant gulls, a soft breeze through the grass, faint acoustic guitar in the background. Photoreal skin and fabric textures, hair strand detail, realistic water physics, golden-hour rim lighting, lens flare, shot on Arri Alexa 35, 50mm anamorphic, shallow depth of field, premium cinematic color grade."
    },
    "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/7349/media-files/input.png"
    },
    "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": "用於指導渲染的附加參考圖像 URL。"
          },
          "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": "無分類器指導尺度控制對提示的遵守。",
      "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/standard/image-to-video。可接受的輸入與輸出請參閱模型的資料結構說明。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/kling/kling-3.0/standard/image-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Bring this still photograph to life with cinematic motion. The young American woman in a flowing white linen sundress stands on a sunlit Pacific Coast cliff at golden hour: her chestnut hair drifts gently in the ocean breeze, the hem of her dress flutters, and she turns her head and breaks into a soft smile as warm sunlight catches her freckles. Behind her, foamy turquoise waves roll and crash against the rocks below, seabirds glide past, and tall coastal grass sways. The camera slowly dollies in from a wide shot to a tender medium close-up, a subtle parallax revealing the depth of the cliffside. Natural ambient sound: gentle Pacific surf, distant gulls, a soft breeze through the grass, faint acoustic guitar in the background. Photoreal skin and fabric textures, hair strand detail, realistic water physics, golden-hour rim lighting, lens flare, shot on Arri Alexa 35, 50mm anamorphic, shallow depth of field, premium cinematic color grade.",
    "start_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7349/media-files/input.png"
  }'

3. API 參考

提交請求

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

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/kling/kling-3.0/standard/image-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Bring this still photograph to life with cinematic motion. The young American woman in a flowing white linen sundress stands on a sunlit Pacific Coast cliff at golden hour: her chestnut hair drifts gently in the ocean breeze, the hem of her dress flutters, and she turns her head and breaks into a soft smile as warm sunlight catches her freckles. Behind her, foamy turquoise waves roll and crash against the rocks below, seabirds glide past, and tall coastal grass sways. The camera slowly dollies in from a wide shot to a tender medium close-up, a subtle parallax revealing the depth of the cliffside. Natural ambient sound: gentle Pacific surf, distant gulls, a soft breeze through the grass, faint acoustic guitar in the background. Photoreal skin and fabric textures, hair strand detail, realistic water physics, golden-hour rim lighting, lens flare, shot on Arri Alexa 35, 50mm anamorphic, shallow depth of field, premium cinematic color grade.",
    "start_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7349/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 with cinematic motion. The young American woman in a flowing white linen sundress stands on a sunlit Pacific Coast cliff at golden hour: her chestnut hair drifts gently in the ocean breeze, the hem of her dress flutters, and she turns her head and breaks into a soft smile as warm sunlight catches her freckles. Behind her, foamy turquoise waves roll and crash against the rocks below, seabirds glide past, and tall coastal grass sways. The camera slowly dollies in from a wide shot to a tender medium close-up, a subtle parallax revealing the depth of the cliffside. Natural ambient sound: gentle Pacific surf, distant gulls, a soft breeze through the grass, faint acoustic guitar in the background. Photoreal skin and fabric textures, hair strand detail, realistic water physics, golden-hour rim lighting, lens flare, shot on Arri Alexa 35, 50mm anamorphic, shallow depth of field, premium cinematic color grade."
    },
    "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/7349/media-files/input.png"
    },
    "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": "用於指導渲染的附加參考圖像 URL。"
          },
          "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": "無分類器指導尺度控制對提示的遵守。",
      "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"
        }
      }
    }
  }
}

透過物理感知運動、攝影機控制和原生音訊將靜態影像動畫化為高保真視頻，以實現快速、電影般的品牌視覺故事敘述。

目錄

1. 快速開始

2. 身分驗證

3. API 參考

提交請求

查詢請求狀態

取得請求結果

取消請求

4. 檔案輸入

託管檔案（URL）

5. 資料結構

輸入結構

輸出結構

透過物理感知運動、攝影機控制和原生音訊將靜態影像動畫化為高保真視頻，以實現快速、電影般的品牌視覺故事敘述。

目錄

1. 快速開始

2. 身分驗證

3. API 參考

提交請求

查詢請求狀態

取得請求結果

取消請求

4. 檔案輸入

託管檔案（URL）

5. 資料結構

輸入結構

輸出結構

Kling 3.0 Standard Image to Video（標準圖生影片）：在 Playground 和 API 上使用實體運動實現影像轉影片 |運作舒適 | Models and API | RunComfy

透過物理感知運動、攝影機控制和原生音訊將靜態影像動畫化為高保真視頻，以實現快速、電影般的品牌視覺故事敘述。

目錄

1. 快速開始

2. 身分驗證

3. API 參考

提交請求

查詢請求狀態

取得請求結果

取消請求

4. 檔案輸入

託管檔案（URL）

5. 資料結構

輸入結構

輸出結構

Kling 3.0 Standard Image to Video（標準圖生影片）：在 Playground 和 API 上使用實體運動實現影像轉影片 |運作舒適 | Models and API | RunComfy

透過物理感知運動、攝影機控制和原生音訊將靜態影像動畫化為高保真視頻，以實現快速、電影般的品牌視覺故事敘述。

目錄

1. 快速開始

2. 身分驗證

3. API 參考

提交請求

查詢請求狀態

取得請求結果

取消請求

4. 檔案輸入

託管檔案（URL）

5. 資料結構

輸入結構

輸出結構