使用 RunComfy 的 API 執行 kling/kling-3.0/pro/image-to-video。 可接受的輸入與輸出請參閱模型的 資料結構說明。
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/kling/kling-3.0/pro/image-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "Bring this still photograph to life with premium cinematic motion. The young American couple ride their two chestnut quarter horses side-by-side across the golden Montana plains at sunset — hooves rhythmically stepping forward, kicking up soft golden dust, horse manes and tails flowing in the prairie wind. The man in the cowboy hat and denim shirt glances over and laughs warmly; the woman in the cream cable-knit sweater laughs back, her wavy auburn hair whipping in the breeze. Tall amber prairie grass sways across the foreground in slow waves, distant Rocky Mountain silhouettes shimmer in heat haze, wispy pink-orange clouds drift slowly across the sky, a few birds wheel overhead. The camera follows in a smooth lateral tracking shot, parallax revealing the vastness of the open plains, then gently pushes in to a tighter two-shot of their faces. Natural ambient sound: rhythmic hoofbeats on dirt trail, leather creaking, wind through tall grass, distant meadowlark calls, and a soft acoustic country guitar score. Photoreal motion realism — every horse muscle flexing, hair strand moving, dust particle drifting, fabric folding — golden-hour rim lighting, lens flare, shot on Arri Alexa 35, 85mm anamorphic, shallow depth of field, premium cinematic color grade, Yellowstone-style.",
"start_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7351/media-files/input.png"
}'將 YOUR_API_TOKEN 環境變數設為您的 API 金鑰（在 個人資料中管理金鑰），並在每個請求的 Authorization 標頭中以 Bearer 權杖形式攜帶： Authorization: Bearer $YOUR_API_TOKEN。
提交非同步生成工作後，將立即取得 request_id 以及用於查詢狀態、取得結果與取消的 URL。
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/kling/kling-3.0/pro/image-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "Bring this still photograph to life with premium cinematic motion. The young American couple ride their two chestnut quarter horses side-by-side across the golden Montana plains at sunset — hooves rhythmically stepping forward, kicking up soft golden dust, horse manes and tails flowing in the prairie wind. The man in the cowboy hat and denim shirt glances over and laughs warmly; the woman in the cream cable-knit sweater laughs back, her wavy auburn hair whipping in the breeze. Tall amber prairie grass sways across the foreground in slow waves, distant Rocky Mountain silhouettes shimmer in heat haze, wispy pink-orange clouds drift slowly across the sky, a few birds wheel overhead. The camera follows in a smooth lateral tracking shot, parallax revealing the vastness of the open plains, then gently pushes in to a tighter two-shot of their faces. Natural ambient sound: rhythmic hoofbeats on dirt trail, leather creaking, wind through tall grass, distant meadowlark calls, and a soft acoustic country guitar score. Photoreal motion realism — every horse muscle flexing, hair strand moving, dust particle drifting, fabric folding — golden-hour rim lighting, lens flare, shot on Arri Alexa 35, 85mm anamorphic, shallow depth of field, premium cinematic color grade, Yellowstone-style.",
"start_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7351/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>"請提供可公開存取的 HTTPS 位址。確保目標主機允許伺服器端抓取（無需登入或 Cookie）、未被限流或阻擋機器人。建議：圖片 ≤ 50 MB（約 4K），影片 ≤ 100 MB（約 720p 下 2–5 分鐘）。私人資產請使用穩定或預先簽署 URL。
{
"type": "object",
"title": "輸入結構",
"required": [
"prompt",
"start_image_url"
],
"properties": {
"prompt": {
"title": "提示詞",
"description": "",
"type": "string",
"default": "Bring this still photograph to life with premium cinematic motion. The young American couple ride their two chestnut quarter horses side-by-side across the golden Montana plains at sunset — hooves rhythmically stepping forward, kicking up soft golden dust, horse manes and tails flowing in the prairie wind. The man in the cowboy hat and denim shirt glances over and laughs warmly; the woman in the cream cable-knit sweater laughs back, her wavy auburn hair whipping in the breeze. Tall amber prairie grass sways across the foreground in slow waves, distant Rocky Mountain silhouettes shimmer in heat haze, wispy pink-orange clouds drift slowly across the sky, a few birds wheel overhead. The camera follows in a smooth lateral tracking shot, parallax revealing the vastness of the open plains, then gently pushes in to a tighter two-shot of their faces. Natural ambient sound: rhythmic hoofbeats on dirt trail, leather creaking, wind through tall grass, distant meadowlark calls, and a soft acoustic country guitar score. Photoreal motion realism — every horse muscle flexing, hair strand moving, dust particle drifting, fabric folding — golden-hour rim lighting, lens flare, shot on Arri Alexa 35, 85mm anamorphic, shallow depth of field, premium cinematic color grade, Yellowstone-style."
},
"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/7351/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 是首選的 ComfyUI 平台，提供 ComfyUI 在線 環境和服務，以及 ComfyUI 工作流程 具有驚豔的視覺效果。 RunComfy還提供 AI Models, 幫助藝術家利用最新的AI工具創作出令人驚艷的藝術作品。