연동 가이드

제공업체 연동 가이드

도구별 설정 단계 및 문제 해결 방법을 확인해 보세요.

제공업체 연동 가이드/ComfyUI 설정 안내

ComfyUI 설정 안내

ComfyUI는 이미지 및 비디오 전용 워크플로 도구입니다. 일반적인 대화형 채팅 도구와 달리 단순히 '모델을 골라 대화하는' 방식이 아니라, 워크플로를 불러온 뒤 프롬프트, 이미지, 파라미터를 각 노드에 입력하여 실행하는 구조입니다.

공식 정보 다운로드 및 문서는 공식 사이트 기준을 참고하세요.
공식 웹사이트 ComfyUI 알아보기 다운로드 링크 Comfy Desktop 및 설치 안내 공식 문서 워크플로, 설치 및 API 문서

먼저 워크플로 이해하기

ComfyUI 워크플로는 일반적으로 모델 로드, 프롬프트, 샘플러, 해상도 설정, 출력 저장 등의 노드로 구성됩니다. 웹 페이지에 보이는 노드와 연결선들이 바로 이미지나 비디오를 생성하는 세부 단계입니다.

API를 통해 ComfyUI를 호출하려면 보통 워크플로를 API 형식의 JSON으로 내보낸 후 로컬 또는 클라우드의 ComfyUI 서비스로 전송해야 합니다.

워크플로 인터페이스 참고 먼저 노드, 연결선, Run 버튼의 동작을 이해한 다음 API 호출을 살펴보세요. ComfyUI의 핵심은 Key가 아니라 워크플로가 정상적으로 실행되는지 여부입니다.
Workflow interface in the official ComfyUI documentation

로컬 주소 입력 방법

설정 항목입력 방법
웹 주소http://127.0.0.1:8188
API 주소http://127.0.0.1:8188/prompt
워크플로workflow-api.json
출력 결과History / Output 폴더
  1. 먼저 ComfyUI를 실행하고 브라우저에서 http://127.0.0.1:8188 접속이 가능한지 확인합니다.
  2. ComfyUI에서 이미 정상적으로 이미지가 생성되는 워크플로를 로드합니다.
  3. 개발자 모드 또는 API 내보내기 옵션을 활성화하고 워크플로를 API JSON 형식으로 저장합니다.
  4. 스크립트나 API 도구를 사용해 해당 JSON을 /prompt 엔드포인트로 전송합니다.
  5. 생성이 완료되면 히스토리 또는 output 폴더에서 결과 이미지를 확인합니다.

API 호출 예시

로컬 ComfyUI로 워크플로 전송
curl -X POST http://127.0.0.1:8188/prompt \ -H "Content-Type: application/json" \ -d @workflow-api.json
이미지/비디오 워크플로에서 발생하는 오류의 대부분은 모델 파일 누락, 노드 버전 불일치, VRAM(비디오 메모리) 부족 때문입니다. Key나 Base URL 설정만 확인하지 마세요.

초보자 자주 묻는 질문 (FAQ)

현상우선 확인 사항해결 방법
웹페이지는 열리는데 API 호출이 실패함요청 주소가 /prompt인지, 워크플로가 API 형식으로 내보내기 되었는지 확인먼저 웹페이지에서 직접 실행해 본 후, API JSON을 다시 내보내세요.
노드 누락(Missing node) 오류 발생워크플로에 현재 PC에 설치되지 않은 커스텀 노드가 사용됨워크플로 안내에 따라 해당 노드를 설치하거나, 다른 기본 워크플로로 테스트해 보세요.
모델 파일 없음(Model file does not exist) 오류 발생Checkpoint, LoRA, VAE 등의 파일 경로 확인모델 파일을 ComfyUI의 해당 디렉터리에 넣고 재시작한 뒤 다시 선택하세요.
VRAM(비디오 메모리) 부족 오류이미지 크기, 배치 수량, 모델 크기 확인해상도와 배치 크기를 먼저 낮춰 생성이 정상 작동하는지 확인한 후 파라미터를 점진적으로 올리세요.