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"
}'환경 변수 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/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>"공개적으로 접근 가능한 HTTPS URL을 제공하세요. 서버 측 페치가 가능하고(로그인/쿠키 불필요) 속도 제한이나 봇 차단이 없어야 합니다. 권장: 이미지 ≤ 50MB(약 4K), 동영상 ≤ 100MB(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 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는 최고의 ComfyUI 플랫폼으로서 ComfyUI 온라인 환경과 서비스를 제공하며 ComfyUI 워크플로우 멋진 비주얼을 제공합니다. RunComfy는 또한 제공합니다 AI Models, 예술가들이 최신 AI 도구를 활용하여 놀라운 예술을 창조할 수 있도록 지원합니다.