본문 바로가기

A LIGHTHOUSE KEEPER'S LOG READING THE PATTERNS OF THE WORLD

AI 스튜디오 대표 이미지 01 / AI STUDIOAI 스튜디오도구가 막히면 등대지기가 먼저 부딪혀 봅니다. 그림·글·자동화, 그리고 돌아가는 길까지 AI Lab 대표 이미지 02 / AI LABAI LabAI 직원들과 회사를 굴리며 실제로 겪은 일을 한 편씩 꺼냅니다 라보의 이세계 여행 대표 이미지 03 / LABO'S ISEKAI라보의 이세계 여행등대지기 라보가 문 너머 다른 세계로 떠나는 툰 연재
VIVA STORY LAB

같이 여행해요.

AI 스튜디오

ComfyUI 워크플로 JSON 파일이 왜 안 열려요?

by Labo 2026. 11. 3.

ComfyUI 워크플로 JSON이 안 열릴 땐 PNG 그림을 끌어다 놓아 보세요. 레시피가 숨어 있거든요. 등대지기 라보입니다. 오늘은 ComfyUI 워크플로 JSON 파일이 왜 안 열리는지, AI가 만들어 준 워크플로 파일이 제 콤피에서 안 열렸던 기록을 이야기할게요. 해 보고 나서 남은 건 두 가지예요. AI가 만들어 준 파일보다 제 손으로 조립한 파일이 기준이고, 그림 파일(PNG) 안에는 그 그림의 레시피가 숨어 있어요. 지난번에 노드를 하나씩 이어서 그림 한 장을 뽑아 본 손님이, 오늘은 "이걸 콤피 켤 때마다 다시 이어야 해요?"부터 물으며 들어왔거든요.

ComfyUI 워크플로 JSON 파일 안 열림, AI가 준 워크플로 JSON, ComfyUI workflow JSON won't open, 등대에서 라보와 손님이 나란히 앉아 같은 모니터를 보는 장면

잘 만든 것처럼 보이는 설계도가 정작 열리지 않는 날이에요.

"ComfyUI 워크플로 JSON 파일이 뭐예요? 매번 손으로 이어야 해요?"

손님: 라보 씨, 지난번에 상자 여러 개 잇는 데만 한참 걸렸어요. 체크포인트 불러오기, 프롬프트, KSampler, VAE 디코드, 저장. 콤피 켤 때마다 이걸 또 해요?

라보: 아니요. 한 번 이어 놓은 그래프는 파일 하나로 저장할 수 있어요. 그게 워크플로 파일이에요. 이름 끝이 .json이고요.

손님: 제이슨이요? 사람 이름 같아요.

라보: 읽는 소리는 그래요. JSON은 글자로만 된 파일이에요. 그림도 아니고 프로그램도 아니라서 메모장으로 열면 그냥 읽혀요. 안에는 그래프 설계도가 적혀 있어요. 어떤 노드가 있는지, 어느 노드가 어느 노드와 이어졌는지, 그리고 각 노드 안의 칸에 무슨 값이 들어 있는지요.

손님: 노드 안의 칸이요?

라보: 지난번에 KSampler 상자 안에 시드, 스텝 수 같은 숫자 칸이 있었죠. 빈 잠재 이미지 상자에는 가로, 세로 칸이 있었고요. 그 칸들을 위젯이라고 불러요. 오늘 계속 나오는 말이라 기억해 두세요.

빈 잠재 이미지 노드 하나를 글로 적으면 대략 이런 모양이에요. 모양만 보는 예시예요.

"5": {
  "class_type": "EmptyLatentImage",
  "inputs": { "width": 832, "height": 1216, "batch_size": 1 }
}

"5"는 이 그래프 안에서 노드 번호, class_type은 노드 종류, inputs 안의 숫자들이 위젯 값이에요. 832와 1216은 제가 기본으로 쓰는 세로 그림 크기인데, 이 숫자 얘기는 따로 한 편을 할 거예요.

손님: 그럼 저장해 두면 다음엔 그 파일만 열면 되는 거예요?

라보: 네. 콤피 메뉴에서 열기를 해도 되고, 파일을 콤피 화면(캔버스)에 끌어다 놓아도 그래프가 펼쳐져요. 남이 만든 파일도 받아서 열 수 있고요.

손님: 와, 그럼 남이 만든 걸 받으면 되겠네요.

라보: 저도 그렇게 생각했어요. 그런데 그게 생각처럼 안 됐어요.

"AI한테 파일로 만들어 달라고 하면 안 돼요?"

손님: 저는 그냥 AI한테 "이런 그래프 만들어 줘" 하고 파일로 받을래요. 손으로 잇는 것보다 빠를 것 같은데요.

라보: 6월 6일에 제가 정확히 그렇게 했어요. Claude한테 워크플로 JSON을 만들어 달라고 해서 받았어요. 글자로 보면 노드도 있고 연결도 있고, 그럴듯했어요.

손님: 그런데요?

라보: 제 콤피에서 안 열렸어요.

손님: 아예요?

라보: 네. 그래서 그 파일을 GPT한테 보여 주고 고쳐 달라고 했어요. GPT가 고친 건 열렸어요.

손님: 그럼 해결된 거 아니에요?

라보: 저도 잠깐은 그렇게 생각했어요. 그런데 가만 보니 이상했어요. Claude가 만든 건 안 열리고 GPT가 고친 건 열렸는데, 둘 사이에 뭐가 달라졌는지 저는 몰랐거든요. 그러면 다음에 또 안 열릴 때도 저는 Claude와 GPT 사이를 오가는 것밖에 할 수 없어요. 파일이 왜 열리는지 모르는 채로 연재 같은 진짜 일을 맡길 수는 없잖아요.

ComfyUI workflow JSON two formats, 화면용 워크플로와 API 형식 워크플로 차이, 노드 위치와 선이 있는 파일과 값만 있는 파일 비교 도식

겉보기엔 둘 다 JSON이지만, 하나는 화면에 펼칠 설계도고 하나는 실행용 목록이에요.

"왜 안 열렸던 거예요?"

라보: 솔직하게 말할게요. 정확한 원인은 제 기록에 없어요. 그래서 일어날 수 있는 경우 두 가지를 설명하고, 어느 쪽이었는지는 모른다고 말씀드릴게요.

① 화면용이 아니라 API 형식 파일이었을 수 있어요.
콤피 워크플로 파일에는 모양이 두 가지 있어요. 하나는 화면용이에요. 노드가 캔버스 어디에 놓였는지, 선이 어떻게 이어졌는지, 상자 크기까지 다 들어 있어요. 우리가 저장하고 여는 보통 파일이 이거예요. 다른 하나는 API 형식이에요. 프로그램이 콤피에게 "이대로 실행해" 하고 보낼 때 쓰는 모양이라, 노드 종류와 값만 있고 화면 위치 정보가 없어요. 위에서 본 예시가 사실 이 API 형식 모양이에요. 이건 화면에 펼쳐 보라고 만든 파일이 아니라서, 화면에서 열면 버전에 따라 그래프로 안 펼쳐질 수 있어요. AI가 글로 그래프를 짜 줄 때 이 모양으로 썼을 수도 있어요.

② 콤피 화면 버전과 안 맞았을 수 있어요.
콤피에서 우리가 보는 화면 부분을 프론트엔드라고 해요. 이게 꽤 자주 업데이트돼요. 업데이트가 쌓이면 파일 안에 적는 방식도 조금씩 바뀌어요. AI가 알고 있던 방식이 제 콤피 버전과 다르면, 내용이 맞아도 제 콤피가 못 읽을 수 있어요.

손님: 그래서 둘 중 뭐였어요?

라보: 모르겠어요. 그때 그걸 확인해서 적어 두지 않았거든요. 제 생각엔 둘 다 가능했던 것 같아요. 그래서 원인을 맞히는 대신 규칙을 하나 세웠어요.

"AI가 만든 파일보다 손으로 이은 파일이 기준이에요?"

라보: 그래서 저는 콤피 안에서 제 손으로 노드를 하나씩 이어 그래프를 다시 만들었어요. 지난번에 손님이랑 한 그 방법 그대로요. 그리고 그걸 돌려서 그림이 나오는 걸 본 다음, 그 파일을 마스터로 정했어요.

손님: 마스터는 원본이라는 뜻이에요?

라보: 네. 제 콤피에서 열리고, 끝까지 돌아가는 게 확인된 파일이요. 그리고 규칙은 이거예요.

검증된 파일을 바탕으로 위젯 값만 바꾼다.

  • 새 그래프를 통째로 받아 와서 쓰지 않아요.
  • 노드와 선은 마스터 그대로 두고, 바꾸는 건 칸 안의 값까지예요. 프롬프트 글, 시드, 스텝 수, 크기 같은 것들이요.
  • 마스터 파일 자체는 덮어쓰지 않고, 값을 바꾼 건 다른 이름으로 저장해 두면 돌아갈 곳이 남아요.

손님: 아, 손으로 이은 게 결국 제일 믿을 만한 거네요.

라보: 네. AI가 만들어 준 파일보다 제 손으로 조립한 게 기준이에요. 제 컴퓨터에서 직접 열리고 돌아간 걸 봤으니까요. 그 한 번이 확인이에요. AI한테 도움을 받더라도 이 규칙 안에서 받으면, 안 열리는 파일 때문에 헤맬 일이 줄어요.

"열리긴 했는데, 그림 크기가 왜 이래요?"

라보: 그런데 다음 날, 규칙만으로는 못 막은 일이 하나 더 있었어요. 새 파일을 불러와서 돌렸는데 그림이 640×1472로 나왔어요. 제가 생각한 크기가 아니었어요.

손님: 파일이 크기를 마음대로 바꿔 버린 거예요?

라보: 아니요. 새 파일이 조용히 안 열렸던 거예요. 오류 창 하나 없이요. 그래서 캔버스에는 전에 쓰던 옛 그래프가 그대로 남아 있었고, 실행 버튼을 누르니 그 옛 그래프가 돌았어요. 640×1472는 그 옛 그래프에 들어 있던 값이었고요.

손님: 그럼 화면만 봐서는 지금 뭐가 도는지 모르는 거네요?

라보: 그게 무서운 점이에요. 콤피는 껐다 켜도 마지막으로 쓰던 캔버스를 기억해서 다시 띄워 두거든요. 그래서 새 파일을 열었다고 믿고 있으면, 옛 그래프가 돌아도 눈치채기 어려워요. 저는 그림 크기가 이상해서 겨우 알았어요.

손님: 그럼 어떻게 확인해요?

라보: 그날부터 확인 절차를 하나 넣었어요. 뽑힌 PNG를 캔버스에 끌어 놓는 거예요. 콤피가 저장한 PNG 안에는 그 그림을 만든 그래프가 같이 들어 있어요. 그래서 그림 파일을 캔버스에 끌어다 놓으면, 그 그림을 실제로 만든 그래프가 열려요.

  • ① 방금 뽑힌 PNG를 콤피 캔버스에 끌어다 놓는다.
  • ② 열린 그래프에서 크기, 로라, 시드 칸을 본다.
  • ③ 내가 불러왔다고 생각한 파일과 같은지 비교한다.

다르면, 내가 연 줄 알았던 파일은 안 열린 거예요. 한 가지만 조심하세요. 콤피가 저장한 PNG를 다른 그림 프로그램에서 다시 저장하거나 어딘가에 올렸다 받으면, 안에 든 그래프 정보가 빠질 수 있어요. 확인은 콤피가 막 저장한 원본 PNG로 하세요.

ComfyUI drag output PNG onto canvas to load workflow, 콤피 출력 PNG를 캔버스에 끌어 놓으면 그 그림을 만든 워크플로가 열림, 실제 그래프 확인

ComfyUI 공식 문서의 예시 PNG(왼쪽)와, 그 PNG를 캔버스에 끌어 놓으면 펼쳐지는 노드 그래프(오른쪽)예요.

손님: 그림이 자기 설계도를 품고 있는 거네요.

라보: 맞아요. 그림 파일(PNG) 안에 그 그림의 레시피가 숨어 있어요. 그래서 화면보다 그림 쪽을 믿기로 했어요.

손님: 이제 파일은 믿어도 되겠어요.

라보: 파일은요. 그런데 그 무렵에 다른 일이 하나 더 있었어요. 그래프는 멀쩡히 돌았는데, 로라 파일을 에폭 4에서 에폭 6으로 바꿔 걸어도 그림이 똑같이 나왔어요.

손님: 에폭이요? 그게 뭔데 똑같으면 안 돼요?

라보: 그 얘기는 다음 편에서 할게요. 로라 에폭 4랑 6 그림이 왜 똑같았는지요.

자주 묻는 질문

Q. ComfyUI 워크플로 파일(JSON)은 뭐예요?
노드 그래프를 글자로 저장한 파일이에요. 어떤 노드가 있고, 어떻게 이어졌고, 각 칸(위젯)에 무슨 값이 들어 있는지가 적혀 있어요. 메모장으로도 열려요.

Q. 받은 워크플로 JSON이 콤피에서 안 열려요.
화면용이 아니라 API 형식 파일이거나, 내 콤피 화면(프론트엔드) 버전과 적는 방식이 다를 수 있어요. 저는 원인을 맞히는 대신, 제 콤피에서 손으로 조립해 돌아가는 걸 확인한 파일을 마스터로 두고 위젯 값만 바꿔요.

Q. 그림 크기가 넣은 값과 다르게 나와요.
새 파일이 조용히 안 열리고 캔버스에 남은 옛 그래프가 돌았을 수 있어요. 뽑힌 PNG를 캔버스에 끌어 놓아 그 그림을 만든 실제 그래프를 확인하세요.

Q. PNG를 끌어 놓았는데 그래프가 안 나와요.
콤피가 저장한 원본 PNG인지 보세요. 다른 프로그램에서 다시 저장했거나 어딘가 올렸다 받은 그림은 그래프 정보가 빠졌을 수 있어요.

공식 주소
ComfyUI 공식 깃허브 (오픈소스, 무료)
ComfyUI 프론트엔드 공식 깃허브 (오픈소스, 무료, 화면 부분)
Claude (Anthropic의 AI)
ChatGPT (OpenAI의 AI, 본문의 GPT)
※ 깃허브는 코드를 공개해 두는 사이트라 실행 전에 안에 뭐가 들었는지 누구나 볼 수 있어요.

이 편에서 작가가 한 일
콤피 안에서 노드를 손으로 하나씩 이어 그래프를 다시 만들고, 끝까지 돌아가는 걸 본 파일을 마스터로 정했다.
그 뒤로는 마스터 위에서 위젯 값만 바꾼다. 그림이 640×1472로 나온 날, 뽑힌 PNG를 캔버스에 끌어 놓아 실제로 돈 그래프를 확인했다.
AI에게 맡긴 일
Claude에게 워크플로 JSON을 만들게 했다. 제 콤피에서 안 열렸다.
GPT에게 그 파일을 고치게 했다. 열렸지만 무엇이 달라졌는지는 알 수 없었다.

시리즈 · AI 웹툰 그리려면
1편 AI 웹툰 그리려면 어떻게 해야할까
2편 스테이블 디퓨전이 뭐예요?
3편 SD1.5, SDXL, FLUX는 뭐가 달라요?
4편 세이프텐서는 왜 이름이 그래요?
5편 AI 그림은 왜 엔비디아예요?
6편 kohya 코야
7편 그림은 몇 장 준비해야 할까?
8편 kohya 학습과 LoRA
9편 그림체 잘 나오나요?
10편 1스텝에 52초, 왜 이렇게 느린거지
11편 런팟은 어떻게 써요?
12편 로라 학습에 좋은 그림을 다 넣었는데 왜 엉뚱한 그림이 나와요?
13편 내 그림, AI 그림 사이트에 올려도 괜찮아요?
14편 스웜 대신 ComfyUI, 포터블로 어떻게 깔아요?
15편 ComfyUI 노드, 기본 워크플로는 어떻게 이어요?
16편 (이 글) ComfyUI 워크플로 JSON 파일이 왜 안 열려요?
17편 (다음) 로라 에폭 4랑 6 그림이 왜 똑같아요?
18편 ComfyUI 그림 크기, 매번 손으로 넣어요?
19편 로라 학습, 같은 캐릭터가 왜 다른 사람처럼 나와요?
20편 로라로 인체가 자꾸 틀어질 때, 몸부터 가르치면 돼요?
21편 로라 캡션, AI한테 맡겨도 돼요?
22편 ControlNet 스케치를 넣으면 AI 그림체가 달라져요?
23편 AI 채색했더니 왜 그림이 납작해져요?
24편 AI 웹툰 얼굴, FaceDetailer로도 왜 아직 안 돼요?

작성 기준: 2026년 10월, 라보의 실제 기록. 콤피 메뉴 이름, 화면 배치, 파일 안에 적는 방식은 버전에 따라 바뀔 수 있어요.

등대 일지. 남이 그려 준 해도보다 내가 직접 다녀온 뱃길이 기준이다. 그리고 돌아온 배의 항해 일지에는 지나온 뱃길이 그대로 적혀 있으니, 해도가 의심스러우면 일지를 펼친다.