# ComfyUI에서 Meshy 사용하는 방법

> URL: https://help.meshy.ai/ko/articles/16102955-how-to-use-meshy-in-comfyui
> Language: ko
> Last updated: 2026-09-09T10:17:22Z

## 개요

Meshy ComfyUI 통합을 사용하면 ComfyUI 워크플로우에서 Meshy API 키를 통해 Meshy의 Text to 3D, Image to 3D, Multi-Image to 3D 생성을 직접 호출할 수 있습니다.

## 설치

ComfyUI Manager를 통해 Meshy 커스텀 노드 팩을 설치하거나("Meshy" 검색), 노드 저장소를 ComfyUI의 `custom_nodes` 폴더에 클론한 후 ComfyUI를 재시작하여 새 노드를 불러오세요.

## API 키 추가

Meshy 계정 설정에서 API 키를 생성한 뒤, 노드 팩 구성 방식에 따라 Meshy 노드의 API 키 필드에 붙여넣거나 환경 변수로 설정하세요. 이 키는 계정의 크레딧 잔액과 연결되어 있으므로 반드시 비공개로 유지하세요.

## 사용 가능한 노드

- **Text to 3D 노드** — 텍스트 프롬프트로부터 모델을 생성합니다

- **Image to 3D 노드** — 단일 참조 이미지로부터 모델을 생성합니다

- **Multi-Image to 3D 노드** — 동일한 오브젝트의 여러 참조 이미지로부터 모델을 생성합니다

각 노드는 Meshy 웹 앱 및 API에서 사용 가능한 동일한 핵심 생성 파라미터를 제공합니다.

## 일반적인 오류

- **인증 오류** — 대개 API 키가 잘못되었거나 누락된 경우입니다. 필요하다면 키를 재생성하세요

- **크레딧 부족** — 계정 잔액이 생성 비용을 충당할 수 없으면 노드가 실패합니다

- **타임아웃** — 긴 생성 작업은 ComfyUI의 기본 노드 타임아웃을 초과할 수 있습니다. 노드가 멈춘 것처럼 보이면 API를 통해 작업 상태를 확인하세요

## 크레딧 및 출력 형식

ComfyUI를 통해 실행되는 생성 작업은 웹 앱이나 API를 통해 실행할 때와 똑같이 Meshy 계정의 크레딧을 소비합니다. 출력 모델은 일반적으로 노드의 내보내기 옵션에 따라 Meshy API에서 지원되는 것과 동일한 형식(예: GLB, FBX, OBJ)으로 저장할 수 있습니다.

## FAQ

### 1. ComfyUI 생성 작업도 웹 앱과 동일한 크레딧을 사용하나요?

네, 동일한 계정 크레딧 잔액에서 차감됩니다.

### 2. 노드에 "unauthorized"라고 표시되는 이유는 무엇인가요?

API 키가 누락되었거나 만료되었거나 잘못 입력되었을 가능성이 높습니다. 계정 설정에서 키를 재생성한 후 노드에 다시 붙여넣으세요.

### 3. Meshy 노드를 다른 ComfyUI 노드와 연결할 수 있나요?

네, 노드 팩의 구현에 따라 Meshy 노드의 출력은 3D 또는 이미지 에셋을 받아들이는 표준 ComfyUI 노드로 전달할 수 있습니다.