RunComfy API로 community/fantasy-portrait/image-to-video을(를) 실행합니다. 허용되는 입력·출력은 모델 스키마.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/community/fantasy-portrait/image-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"143_image": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/Runcomfy_example_1268_1.png",
"160_video": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/Runcomfy_example_1268_1.mp4",
"155_positive_prompt": "woman acting"
}'환경 변수 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/community/fantasy-portrait/image-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"143_image": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/Runcomfy_example_1268_1.png",
"160_video": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/Runcomfy_example_1268_1.mp4",
"155_positive_prompt": "woman acting"
}'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": [
"143_image",
"160_video",
"155_positive_prompt"
],
"properties": {
"160_video": {
"title": "참조 영상",
"description": "생성할 움직임의 기준이 되는 필수 영상입니다.",
"type": "string",
"default": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/Runcomfy_example_1268_1.mp4"
},
"143_image": {
"title": "인물 이미지",
"description": "영상으로 움직일 인물이 담긴 필수 이미지입니다.",
"type": "string",
"default": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/Runcomfy_example_1268_1.png"
},
"155_positive_prompt": {
"title": "프롬프트",
"description": "원하는 동작, 표정, 영상 방향을 설명하는 필수 텍스트입니다.",
"type": "string",
"default": "woman acting"
},
"169_valuex170_value": {
"title": "해상도(너비:높이)",
"description": "정사각형, 세로형, 가로형을 포함한 10개 규격 중에서 선택합니다. 기본값은 720x720 (1:1)입니다.",
"type": "string",
"enum": [
"480x480 (1:1)",
"720x720 (1:1)",
"480x720 (2:3)",
"720x480 (3:2)",
"540x960 (9:16)",
"576x1024 (9:16)",
"720x1280 (9:16)",
"960x540 (16:9)",
"1024x576 (16:9)",
"1280x720 (16:9)"
],
"default": "720x720 (1:1)"
},
"174_value": {
"title": "프레임 수",
"description": "81 또는 141프레임을 선택합니다. 기본값은 81입니다.",
"type": "integer",
"enum": [
81,
141
],
"default": 81
},
"163_frame_rate": {
"title": "초당 프레임",
"description": "프레임 속도를 12~24 FPS로 설정합니다. 기본값은 16입니다.",
"type": "integer",
"default": 16,
"minimum": 12,
"maximum": 24
},
"150_strength": {
"title": "인물 강도",
"description": "Fantasy Portrait 임베딩이 영상에 미치는 정도입니다. 값을 높이면 인물 특징과 표정이 더 강조됩니다. 범위는 0.3~2.0, 기본값은 1입니다.",
"type": "float",
"default": 1,
"minimum": 0.3,
"maximum": 2
},
"149_seed": {
"title": "시드",
"description": "결과를 비슷하게 재현하거나 다른 변형을 만들 때 쓰는 정수입니다. 기본값은 96860978입니다.",
"type": "integer",
"default": 96860978
},
"149_steps": {
"title": "샘플링 단계",
"description": "노이즈 제거 반복 횟수입니다. 값을 높이면 디테일과 안정성이 좋아질 수 있지만 처리 시간이 늘어납니다. 범위는 6~20, 기본값은 6입니다.",
"type": "integer",
"default": 6,
"minimum": 6,
"maximum": 20
},
"149_cfg": {
"title": "가이던스 스케일",
"description": "프롬프트 충실도와 표현의 자유도 사이 균형을 조절합니다. 범위는 0.6~2.0, 기본값은 1입니다.",
"type": "float",
"default": 1,
"minimum": 0.6,
"maximum": 2
},
"149_shift": {
"title": "샘플링 시프트",
"description": "샘플링 진행 방식을 조절합니다. 값을 높이면 안정성이 낮아질 수 있지만 움직임이나 스타일은 더 강해집니다. 범위는 1~15, 기본값은 5입니다.",
"type": "integer",
"default": 5,
"minimum": 1,
"maximum": 15
}
}
}{
"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 도구를 활용하여 놀라운 예술을 창조할 수 있도록 지원합니다.