modelApiDoc_getStartedBeforeModelkling/kling-3.0/4k/image-to-videomodelApiDoc_getStartedAfterModel modelApiDoc_getStartedMid modelApiDoc_schemaLinkmodelApiDoc_getStartedAfterSchema
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"
}'modelApiDoc_authP1 YOUR_API_TOKEN modelApiDoc_authP2 modelApiDoc_profilemodelApiDoc_authP3 Authorization modelApiDoc_authP4 Authorization: Bearer $YOUR_API_TOKENmodelApiDoc_authP5
modelApiDoc_submitBody
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"
}'modelApiDoc_monitorBody
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
--header "Authorization: Bearer <token>"modelApiDoc_retrieveBody
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
--header "Authorization: Bearer <token>"modelApiDoc_cancelBody
curl --request POST \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
--header "Authorization: Bearer <token>"modelApiDoc_hostedFileBody
{
"type": "object",
"title": "modelApiDoc_navInputSchema",
"required": [
"prompt",
"start_image_url"
],
"properties": {
"prompt": {
"title": "Prompt",
"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": "Multi Prompt Segments",
"description": "Provide multiple prompt segments for scene transitions. The sum of all segment durations must equal the total video duration.",
"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": "Start Image",
"description": "Starting image of the video. Supports jpg, jpeg, png, bmp, webp formats.",
"type": "string",
"default": "https://playgrounds-storage-public.runcomfy.net/tools/7353/media-files/input.png"
},
"end_image_url": {
"title": "End Image",
"description": "Optional ending image for controlled transitions between two frames. Supports jpg, jpeg, png, bmp, webp formats.",
"type": "string"
},
"duration": {
"title": "Duration",
"description": "Total duration of the generated video in seconds.",
"type": "integer",
"minimum": 3,
"maximum": 15,
"default": 10
},
"generate_audio": {
"title": "Generate Audio",
"description": "Enable this option to generate audio for the video.",
"type": "boolean",
"default": true
},
"elements": {
"title": "Elements",
"description": "Input assets used for generation, including reference images and video segments.",
"type": "array",
"items": {
"type": "object",
"properties": {
"frontal_image_url": {
"type": "string",
"format": "image_uri",
"description": "Frontal image reference for the subject."
},
"reference_image_urls": {
"type": "array",
"format": "image_uris",
"items": {
"type": "string",
"format": "image_uri"
},
"description": "Additional reference image URLs used to guide rendering."
},
"video_url": {
"type": "string",
"format": "video_uri",
"description": "Optional source video used for motion reference."
}
}
},
"minItems": 0,
"maxItems": 3
},
"shot_type": {
"title": "Shot Type",
"description": "Defines how the camera shot or scene framing is handled.",
"type": "string",
"enum": [
"customize"
],
"default": "customize"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "",
"type": "string"
},
"cfg_scale": {
"title": "Guidance Scale",
"description": "Classifier-Free Guidance scale controlling adherence to the prompt.",
"type": "float",
"minimum": 0,
"maximum": 1,
"default": 0.5
}
}
}{
"output": {
"type": "object",
"properties": {
"image": {
"type": "string",
"format": "uri",
"description": "modelApiDoc_outDescImage"
},
"video": {
"type": "string",
"format": "uri",
"description": "modelApiDoc_outDescVideo"
},
"images": {
"type": "array",
"description": "modelApiDoc_outDescImages",
"items": {
"type": "string",
"format": "uri"
}
},
"videos": {
"type": "array",
"description": "modelApiDoc_outDescVideos",
"items": {
"type": "string",
"format": "uri"
}
}
}
}
}RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.