RunComfy API로 ltx/ltx-2-19b/video-to-video/lora을(를) 실행합니다. 허용되는 입력·출력은 모델 스키마.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/ltx/ltx-2-19b/video-to-video/lora \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "black-and-white video, a girl is playing a guitar, film grain",
"video_url": "https://playgrounds-storage-public.runcomfy.net/tools/7312/media-files/input-1-1.mp4",
"loras": [
{
"path": "Lightricks/LTX-2-19b-IC-LoRA-Detailer",
"scale": 1
}
]
}'환경 변수 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/ltx/ltx-2-19b/video-to-video/lora \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "black-and-white video, a girl is playing a guitar, film grain",
"video_url": "https://playgrounds-storage-public.runcomfy.net/tools/7312/media-files/input-1-1.mp4",
"loras": [
{
"path": "Lightricks/LTX-2-19b-IC-LoRA-Detailer",
"scale": 1
}
]
}'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",
"video_url",
"loras"
],
"properties": {
"prompt": {
"title": "프롬프트",
"description": "",
"type": "string",
"default": "black-and-white video, a girl is playing a guitar, film grain"
},
"video_url": {
"title": "동영상 URL",
"description": "동영상을 생성할 동영상의 URL입니다.",
"type": "string",
"default": "https://playgrounds-storage-public.runcomfy.net/tools/7312/media-files/input-1-1.mp4"
},
"image_url": {
"title": "이미지",
"description": "동영상의 첫 번째 프레임으로 사용할 이미지의 선택적 URL입니다.",
"type": "string"
},
"loras": {
"title": "LoRA",
"description": "적용할 LoRA 목록(최대 10개).",
"type": "array",
"default": [
{
"path": "Lightricks/LTX-2-19b-IC-LoRA-Detailer",
"scale": 1
}
],
"items": {
"path": {
"title": "LoRA 경로",
"description": "LoRA 가중치의 URL 또는 Hugging Face 저장소 ID(owner/repo).",
"type": "string",
"format": "str",
"default": ""
},
"scale": {
"title": "LoRA 스케일",
"description": "LoRA 모델의 적용 강도.",
"type": "float",
"format": "float_slider_with_range",
"minimum": 0,
"maximum": 4,
"default": 1
}
},
"maxItems": 10,
"minItems": 0
},
"match_video_length": {
"title": "원본 동영상 길이 맞추기",
"description": "활성화하면 동영상 길이와 FPS를 기준으로 프레임 수를 계산합니다. 비활성화하면 num_frames 값을 사용합니다.",
"type": "boolean",
"default": true
},
"num_frames": {
"title": "프레임 수",
"description": "생성할 프레임 수입니다.",
"type": "integer",
"minimum": 9,
"maximum": 481,
"default": 121
},
"video_size": {
"title": "동영상 크기",
"description": "생성된 동영상의 크기입니다.",
"type": "string",
"enum": [
"auto",
"square_hd",
"square",
"portrait_4_3",
"portrait_16_9",
"landscape_4_3",
"landscape_16_9"
],
"default": "auto"
},
"generate_audio": {
"title": "오디오 생성",
"description": "동영상에 대한 오디오를 생성할지 여부입니다.",
"type": "boolean",
"default": true
},
"use_multiscale": {
"title": "다중 스케일 생성 사용",
"description": "활성화하면 먼저 작은 크기로 생성한 뒤 최종 크기에서 디테일을 다듬습니다.",
"type": "boolean",
"default": true
},
"match_input_fps": {
"title": "입력 FPS 맞추기",
"description": "true이면 기본 출력 FPS 대신 입력 동영상의 FPS에 맞춥니다.",
"type": "boolean",
"default": true
},
"fps": {
"title": "프레임률",
"description": "생성된 동영상의 초당 프레임 수입니다.",
"type": "float",
"minimum": 1,
"maximum": 60,
"default": 25
},
"guidance_scale": {
"title": "가이던스 스케일",
"description": "프롬프트가 생성을 이끄는 강도.",
"type": "float",
"minimum": 1,
"maximum": 10,
"default": 3
},
"num_inference_steps": {
"title": "추론 단계 수",
"description": "사용할 추론 단계 수입니다.",
"type": "integer",
"minimum": 8,
"maximum": 50,
"default": 40
},
"camera_lora": {
"title": "카메라 LoRA",
"description": "카메라 움직임을 제어하는 데 사용하는 카메라 LoRA입니다.",
"type": "string",
"enum": [
"dolly_in",
"dolly_out",
"dolly_left",
"dolly_right",
"jib_up",
"jib_down",
"static",
"none"
],
"default": "none"
},
"camera_lora_scale": {
"title": "카메라 LoRA 스케일",
"description": "카메라 움직임 제어에 사용하는 카메라 LoRA의 적용 강도.",
"type": "float",
"minimum": 0,
"maximum": 1,
"default": 1
},
"negative_prompt": {
"title": "네거티브 프롬프트",
"description": "결과에서 피하고 싶은 요소나 결함을 지정합니다.",
"type": "string",
"default": "blurry, out of focus, overexposed, underexposed, low contrast, washed out colors, excessive noise, grainy texture, poor lighting, flickering, motion blur, distorted proportions, unnatural skin tones, deformed facial features, asymmetrical face, missing facial features, extra limbs, disfigured hands, wrong hand count, artifacts around text, inconsistent perspective, camera shake, incorrect depth of field, background too sharp, background clutter, distracting reflections, harsh shadows, inconsistent lighting direction, color banding, cartoonish rendering, 3D CGI look, unrealistic materials, uncanny valley effect, incorrect ethnicity, wrong gender, exaggerated expressions, wrong gaze direction, mismatched lip sync, silent or muted audio, distorted voice, robotic voice, echo, background noise, off-sync audio,incorrect dialogue, added dialogue, repetitive speech, jittery movement, awkward pauses, incorrect timing, unnatural transitions, inconsistent framing, tilted camera, flat lighting, inconsistent tone, cinematic oversaturation, stylized filters, or AI artifacts."
},
"seed": {
"title": "시드",
"description": "",
"type": "integer",
"default": 0
},
"enable_prompt_expansion": {
"title": "프롬프트 확장 활성화",
"description": "프롬프트를 자동으로 확장할지 설정합니다.",
"type": "boolean",
"default": false
},
"video_output_type": {
"title": "동영상 출력 형식",
"description": "생성된 동영상의 출력 유형입니다.",
"type": "string",
"enum": [
"X264 (.mp4)",
"VP9 (.webm)",
"PRORES4444 (.mov)",
"GIF (.gif)"
],
"default": "X264 (.mp4)"
},
"video_quality": {
"title": "동영상 품질",
"description": "생성된 동영상의 품질.",
"type": "string",
"enum": [
"low",
"medium",
"high",
"maximum"
],
"default": "high"
},
"preprocessor": {
"title": "전처리기",
"description": "입력 동영상에 적용할 전처리기.",
"type": "string",
"enum": [
"depth",
"canny",
"pose",
"none"
],
"default": "none"
},
"ic_lora": {
"title": "IC-LoRA",
"description": "로드할 IC-LoRA 유형입니다.",
"type": "string",
"enum": [
"match_preprocessor",
"canny",
"depth",
"pose",
"detailer",
"none"
],
"default": "match_preprocessor"
},
"ic_lora_scale": {
"title": "IC-LoRA 스케일",
"description": "사용할 IC-LoRA의 적용 강도입니다.",
"type": "float",
"minimum": 0,
"maximum": 1,
"default": 1
},
"video_strength": {
"title": "원본 동영상 추종 강도",
"description": "원본 동영상을 조건으로 사용하는 강도입니다. 값이 낮을수록 모델이 내용을 더 자유롭게 변경할 수 있습니다.",
"type": "float",
"minimum": 0,
"maximum": 1,
"default": 1
}
}
}{
"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 도구를 활용하여 놀라운 예술을 창조할 수 있도록 지원합니다.