메인 콘텐츠로 건너뛰기
ComfyUI는 기본적으로 사용자의 컴퓨터에서 HTTP 서버로 실행됩니다. 브라우저를 열지 않고도 워크플로우 제출, 파일 업로드, 결과 다운로드, 진행 상황 모니터링을 프로그래매틱하게 수행할 수 있습니다.

​
서버 시작하기

ComfyUI를 실행하면 자동으로 http://127.0.0.1:8188에서 HTTP 서버가 시작됩니다. 헤드리스 서버(브라우저 없이)로 ComfyUI를 실행하려면: 
# Run without opening the browser
python main.py --disable-auto-launch
시작 플래그 전체 목록을 보려면 python main.py --help를 실행하거나 시작 플래그 참조를 확인하세요.

​
이 섹션의 주요 페이지

시작 플래그

main.py 명령줄 인수에 대한 완전한 참조입니다.

API 라우트

워크플로우 제출, 파일 업로드, 상태 조회를 위한 HTTP 엔드포인트입니다.

API 예제

API 호출 코드 예제: HTTP 전용, WebSocket + History, SaveImageWebsocket.

서버 메시지

실행 중에 서버가 클라이언트로 전송하는 WebSocket 메시지 유형입니다.

실행 모델 반전

고급: 사용자 정의 제어 흐름을 위해 실행을 반전합니다.

​
파트너 노드 사용

워크플로우에 유료 파트너 노드가 포함되어 있다면 페이로드에 API 키를 포함할 수 있습니다. 자세한 내용은 파트너 노드 API 통합 가이드를 참조하세요.

​
서버 작동 방식

Comfy 서버는 aiohttp 프레임워크 위에서 실행되며, 이 프레임워크는 다시 asyncio를 사용합니다. 서버에서 클라이언트로 보내는 메시지는 서버의 send_sync 메서드를 통해 소켓 메시지로 전송되며, 이 메서드는 server.py에 정의된 PromptServer 인스턴스입니다. 이러한 메시지는 api.js에 등록된 소켓 이벤트 리스너에 의해 처리됩니다. 자세한 내용은 메시지를 참조하세요. 클라이언트에서 서버로 보내는 메시지는 api.js에 정의된 api.fetchApi() 메서드를 통해 전송되며, 서버가 정의한 HTTP 라우트에 의해 처리됩니다. 자세한 내용은 라우트를 참조하세요.
클라이언트는 요청을 대기열에 넣을 때 전체 워크플로우(위젯 값 및 모든 내용)를 제출합니다. 서버는 요청을 대기열에 보낸 후에 여러분이 수정한 내용은 전혀 수신하지 않습니다. 만약 실행 중에 서버 동작을 변경하고 싶다면 라우트를 사용해야 합니다.