ComfyUI 커스텀 노드 데이터 타입 레퍼런스: Python 타입, 텐서 형식(IMAGE, LATENT, MASK), 커스텀 타입, INPUT_TYPES의 와일드카드.
다음은 가장 중요한 내장 데이터 타입입니다. 또한 자신만의 데이터 타입을 정의할 수도 있습니다.데이터 타입은 클라이언트 측에서 워크플로우가 잘못된 형태의 데이터를 노드에 전달하는 것을 방지하는 데 사용됩니다—강력한 타이핑과 비슷합니다.
JavaScript 클라이언트 측 코드는 일반적으로 노드 출력을 다른 데이터 타입의 입력에 연결하지 못하도록 합니다.
다만 아래에 몇 가지 예외 사항이 나와 있습니다.
Comfy 데이터 타입
COMBO
INPUT_TYPES에 추가적인 파라미터 없음
Python 데이터 타입: list[str]로 정의되며, 출력 값은 str입니다.
드롭다운 메뉴 위젯을 나타냅니다.
다른 데이터 타입과 달리, COMBO는 INPUT_TYPES에서 str로 지정되지 않고 드롭다운 목록의 옵션에 해당하는 list[str]로 지정되며, 기본적으로 첫 번째 옵션이 선택됩니다.COMBO 입력은 종종 런타임에 동적으로 생성됩니다. 예를 들어 내장된 CheckpointLoaderSimple 노드에서는 다음과 같이 찾을 수 있습니다:
프리미티브 및 리루트 노드는 클라이언트 측에만 존재합니다. 이들은 본질적인 데이터 타입을 갖지 않지만, 연결될 때 연결된 입력이나 출력의 데이터 타입을 따릅니다(그래서 * 입력에 연결할 수 없는 것입니다…).
Python 데이터 타입
INT
INPUT_TYPES에 추가적인 파라미터:
default는 필수입니다.
min과 max는 선택적입니다.
Python 데이터 타입 int
FLOAT
INPUT_TYPES에 추가적인 파라미터:
default는 필수입니다.
min, max, step는 선택적입니다.
Python 데이터 타입 float
STRING
INPUT_TYPES에 추가적인 파라미터:
default는 필수입니다.
Python 데이터 타입 str
BOOLEAN
INPUT_TYPES에 추가적인 파라미터:
default는 필수입니다.
Python 데이터 타입 bool
텐서 데이터 타입
IMAGE
INPUT_TYPES에 추가적인 파라미터 없음
Python 데이터 타입 torch.Tensor이며, shape는 [B,H,W,C]입니다.
B개의 이미지, 높이 H, 너비 W, 채널 수 C(일반적으로 RGB의 경우 C=3)의 배치입니다.
LATENT
INPUT_TYPES에 추가적인 파라미터 없음
Python 데이터 타입 dict이며, shape는 [B,C,H,W]인 torch.Tensor를 포함합니다.
전달되는 dict에는 samples라는 키가 있으며, 이는 shape [B,C,H,W]인 torch.Tensor로, B개의 잠재 변수 배치를 나타내며, 채널 수는 C(일반적으로 기존 안정적 확산 모델의 경우 C=4), 높이 H, 너비 W입니다.높이와 너비는 해당 이미지 크기의 1/8입니다(이는 Empty Latent Image 노드에서 설정한 값입니다).dict의 다른 항목에는 잠재 마스크 같은 것이 포함됩니다.
MASK
INPUT_TYPES에 추가적인 파라미터 없음
Python 데이터 타입 torch.Tensor이며, shape는 [H,W] 또는 [B,C,H,W]입니다.
AUDIO
INPUT_TYPES에 추가적인 파라미터 없음
Python 데이터 타입 dict이며, shape는 [B, C, T]인 torch.Tensor와 샘플 속도를 포함합니다.
전달되는 dict에는 waveform이라는 키가 있으며, 이는 shape [B, C, T]인 torch.Tensor로, B개의 오디오 샘플 배치를 나타내며, 채널 수는 C(C=2 스테레오, C=1 모노), 시간 단계 수는 T입니다(즉, 오디오 샘플의 개수).dict에는 또 다른 키인 sample_rate가 있으며, 이는 오디오의 샘플링 속도를 나타냅니다.
맞춤형 샘플링 데이터 타입
Noise
NOISE 데이터 타입은 노이즈의 소스를 나타냅니다(실제 노이즈 자체가 아님). 이는 generate_noise(self, input_latent:Tensor) -> Tensor 시그니처를 가진 노이즈 생성 메서드와 seed:Optional[int] 속성을 제공하는 모든 Python 객체로 표현될 수 있습니다.
seed는 SamplerCustomAdvanced의 sample 가이더에 전달되지만, 표준 가이더에서는 사용되지 않는 것으로 보입니다. 이는 선택적이므로 일반적으로 None으로 설정할 수 있습니다.
노이즈를 추가할 때, 잠재 변수가 이 메서드에 전달되며, 이는 동일한 shape의 노이즈를 포함한 Tensor를 반환해야 합니다.노이즈 혼합 예시 참조
Sampler
SAMPLER 데이터 타입은 샘플러를 나타내며, 이는 sample 메서드를 제공하는 Python 객체로 표현됩니다. 안정적 확산 샘플링은 이 가이드의 범위를 벗어납니다; 이 코드 부분을 자세히 살펴보려면 comfy/samplers.py를 참고하세요.
Sigmas
SIGMAS 데이터 타입은 스케줄러가 생성한 샘플링 과정의 각 단계 전후의 시그마 값을 나타냅니다. 이는 길이가 steps+1인 1차원 텐서로, 각 요소는 해당 단계 전에 존재할 것으로 예상되는 노이즈를 나타내며, 마지막 값은 최종 단계 이후의 노이즈를 나타냅니다.20단계와 1의 디노이즈를 가진 normal 스케줄러는 SDXL 모델에서 다음과 같은 값을 생성합니다:
시그마의 시작값은 모델에 따라 다르므로, 스케줄러 노드는 SIGMAS 출력을 생성하려면 MODEL 입력이 필요합니다
Guider
GUIDER는 ‘안내’된 프롬프트나 기타 조건부 형태에 의해 ‘유도’된 디노이징 과정의 일반화입니다. Comfy에서 가이더는 callable Python 객체로 표현되며, __call__(*args, **kwargs) 메서드를 제공하고 이 메서드는 샘플에 의해 호출됩니다.__call__ 메서드는 (args[0]에) 노이즈가 있는 잠재 변수 배치(tensor [B,C,H,W])를 받아들여, 동일한 shape의 노이즈 예측값(Tensor`)을 반환합니다.
모델 데이터 타입
안정적 확산 모델을 위한 더 많은 기술적 데이터 타입이 있습니다. 가장 중요한 것은 MODEL, CLIP, VAE, 그리고 CONDITIONING입니다. 이들과 함께 작업하는 것은 (당분간) 이 가이드의 범위를 벗어납니다!
추가 파라미터
아래는 입력 정의의 ‘추가 옵션’ 부분에서 사용할 수 있는 공식 지원 키들의 목록입니다.
자신만의 맞춤 위젯을 위해 추가 키를 사용할 수 있지만, 아래 키들을 다른 용도로 재사용해서는 안 됩니다.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"ComfyUI","colors":{"primary":"#49378B","light":"#F2FF59","dark":"#F2FF59"},"logo":{"light":"https://mintcdn.com/dripart/WCFdTagRdhtvk9-o/logo/light.svg?fit=max\u0026auto=format\u0026n=WCFdTagRdhtvk9-o\u0026q=85\u0026s=ec112de87239058f5a931a7e4b594965","dark":"https://mintcdn.com/dripart/QzWbjSCBG7w61rR3/logo/dark.svg?fit=max\u0026auto=format\u0026n=QzWbjSCBG7w61rR3\u0026q=85\u0026s=62b4d879fb3aadbd7a468d1539032d6f","href":"/"},"favicon":"https://mintcdn.com/dripart/maKDA164-rrTfyxY/favicon.ico?fit=max\u0026auto=format\u0026n=maKDA164-rrTfyxY\u0026q=85\u0026s=94f3a697cf4c9a1ee3961b69219d0942","appearance":{"default":"dark"},"navbar":{"links":[{"href":"https://blog.comfy.org/?utm_source=docs","label":"Blog"},{"href":"/tutorials/partner-nodes/pricing","label":"Pricing"},{"href":"https://platform.comfy.org/?utm_source=docs","label":"Platform"},{"href":"https://comfy.org/download?utm_source=docs","label":"Download"}],"primary":{"type":"button","label":"Comfy Cloud","href":"https://comfy.org/cloud?utm_source=docs"}},"footer":{"socials":{"github":"https://github.com/Comfy-Org/ComfyUI","x":"https://x.com/ComfyUI","discord":"https://discord.com/invite/comfyorg","youtube":"https://www.youtube.com/@comfyorg"},"links":[{"header":"Resources","items":[{"label":"installation","href":"/installation/system_requirements"},{"label":"Tutorials","href":"/tutorials/basic/text-to-image"},{"label":"Development","href":"/development/overview"}]},{"header":"Products","items":[{"label":"Features","href":"https://www.comfy.org/?utm_source=docs"},{"label":"Gallery","href":"https://www.comfy.org/gallery?utm_source=docs"},{"label":"Download","href":"https://www.comfy.org/download?utm_source=docs"}]},{"header":"Company","items":[{"label":"About","href":"https://www.comfy.org/about?utm_source=docs"},{"label":"Careers","href":"https://www.comfy.org/careers?utm_source=docs"},{"label":"Terms of Service","href":"https://www.comfy.org/terms-of-service?utm_source=docs"},{"label":"Privacy Policy","href":"https://www.comfy.org/privacy-policy?utm_source=docs"}]}]},"search":{"prompt":"Search Comfy documentation..."},"seo":{"metatags":{"googlebot":"max-video-preview:0"}},"icons":{"library":"fontawesome"},"integrations":{"ga4":{"measurementId":"G-MXC01ZDDHQ"},"posthog":{"apiKey":"phc_iKfK86id4xVYws9LybMje0h44eGtfwFgRPIBehmy8rO"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":true},"navigation":{"languages":[{"language":"en","href":""},{"language":"zh","footer":{"socials":{"github":"https://github.com/Comfy-Org/ComfyUI","x":"https://x.com/ComfyUI","discord":"https://discord.com/invite/comfyorg","youtube":"https://www.youtube.com/@comfyorg"},"links":[{"header":"资源","items":[{"label":"安装","href":"/zh/installation/system_requirements"},{"label":"教程","href":"/zh/tutorials/basic/text-to-image"},{"label":"开发","href":"/zh/development/overview"}]},{"header":"产品","items":[{"label":"功能","href":"https://www.comfy.org/?utm_source=docs"},{"label":"画廊","href":"https://www.comfy.org/gallery?utm_source=docs"},{"label":"下载","href":"https://www.comfy.org/download?utm_source=docs"}]},{"header":"公司","items":[{"label":"关于","href":"https://www.comfy.org/about?utm_source=docs"},{"label":"招聘","href":"https://www.comfy.org/careers?utm_source=docs"},{"label":"服务条款","href":"https://www.comfy.org/terms-of-service?utm_source=docs"},{"label":"隐私政策","href":"https://www.comfy.org/privacy-policy?utm_source=docs"}]}]},"href":"zh"},{"language":"ja","footer":{"socials":{"github":"https://github.com/Comfy-Org/ComfyUI","x":"https://x.com/ComfyUI","discord":"https://discord.com/invite/comfyorg","youtube":"https://www.youtube.com/@comfyorg"},"links":[{"header":"リソース","items":[{"label":"インストール","href":"/ja/installation/system_requirements"},{"label":"チュートリアル","href":"/ja/tutorials/basic/text-to-image"},{"label":"開発","href":"/ja/development/overview"}]},{"header":"プロダクト","items":[{"label":"機能","href":"https://www.comfy.org/?utm_source=docs"},{"label":"ギャラリー","href":"https://www.comfy.org/gallery?utm_source=docs"},{"label":"ダウンロード","href":"https://www.comfy.org/download?utm_source=docs"}]},{"header":"会社情報","items":[{"label":"概要","href":"https://www.comfy.org/about?utm_source=docs"},{"label":"採用情報","href":"https://www.comfy.org/careers?utm_source=docs"},{"label":"利用規約","href":"https://www.comfy.org/terms-of-service?utm_source=docs"},{"label":"プライバシーポリシー","href":"https://www.comfy.org/privacy-policy?utm_source=docs"}]}]},"navbar":{"links":[{"href":"/ja/tutorials/partner-nodes/pricing","label":"料金"},{"href":"https://comfy.org/download?utm_source=docs","label":"ダウンロード"}],"primary":{"type":"button","label":"Comfy Cloud","href":"https://comfy.org/cloud?utm_source=docs"}},"href":"ja"},{"language":"ko","footer":{"socials":{"github":"https://github.com/Comfy-Org/ComfyUI","x":"https://x.com/ComfyUI","discord":"https://discord.com/invite/comfyorg","youtube":"https://www.youtube.com/@comfyorg"},"links":[{"header":"리소스","items":[{"label":"설치","href":"/ko/installation/system_requirements"},{"label":"튜토리얼","href":"/ko/tutorials/basic/text-to-image"},{"label":"개발","href":"/ko/development/overview"}]},{"header":"제품","items":[{"label":"기능","href":"https://www.comfy.org/?utm_source=docs"},{"label":"갤러리","href":"https://www.comfy.org/gallery?utm_source=docs"},{"label":"다운로드","href":"https://www.comfy.org/download?utm_source=docs"}]},{"header":"회사 정보","items":[{"label":"소개","href":"https://www.comfy.org/about?utm_source=docs"},{"label":"채용","href":"https://www.comfy.org/careers?utm_source=docs"},{"label":"이용약관","href":"https://www.comfy.org/terms-of-service?utm_source=docs"},{"label":"개인정보 처리방침","href":"https://www.comfy.org/privacy-policy?utm_source=docs"}]}]},"navbar":{"links":[{"href":"/ko/tutorials/partner-nodes/pricing","label":"가격 정책"},{"href":"https://comfy.org/download?utm_source=docs","label":"다운로드"}],"primary":{"type":"button","label":"Comfy Cloud","href":"https://comfy.org/cloud?utm_source=docs"}},"href":"ko"},{"language":"es","href":"es"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"dripart","hasAudioNarration":false,"actualSubdomain":"dripart","customDomains":["docs.comfy.org"],"gitSource":{"type":"github","owner":"comfy-org","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":true,"issues":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6afe5ea9a299797a47b3fb8c","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"en","tag":"Built-in Nodes","count":1185},{"language":"ja","tag":"組み込みノード","count":1185},{"language":"zh","tag":"内置节点","count":1185},{"language":"en","tag":"Nodes","count":1184},{"language":"ja","tag":"ノード","count":1184},{"language":"zh","tag":"节点","count":1184},{"language":"ko","tag":"내장 노드 (Built-in Nodes)","count":1143},{"language":"ko","tag":"노드","count":1142},{"language":"es","tag":"Nodos integrados","count":1077},{"language":"es","tag":"Nodos","count":1076},{"language":"en","tag":"Tutorials","count":430},{"language":"es","tag":"Tutoriales","count":430},{"language":"en","tag":"Model","count":382},{"language":"ja","tag":"Model","count":382},{"language":"ko","tag":"Model","count":382},{"language":"zh","tag":"Model","count":382},{"language":"es","tag":"Modelo","count":378},{"language":"en","tag":"Image","count":362},{"language":"en","tag":"Partner","count":359},{"language":"ja","tag":"Partner","count":359},{"language":"ko","tag":"Partner","count":359},{"language":"zh","tag":"Partner","count":359},{"language":"es","tag":"Partner","count":357},{"language":"ja","tag":"はじめに","count":352},{"language":"ko","tag":"시작하기","count":352},{"language":"zh","tag":"开始使用","count":352},{"language":"ja","tag":"API 開発","count":341},{"language":"ko","tag":"API 개발","count":341},{"language":"zh","tag":"API 开发","count":341},{"language":"es","tag":"Imagen","count":331},{"language":"es","tag":"Comfy Router","count":312},{"language":"ja","tag":"Comfy Router","count":303},{"language":"ko","tag":"Comfy Router","count":303},{"language":"zh","tag":"Comfy Router","count":303},{"language":"en","tag":"Comfy Router","count":301},{"language":"en","tag":"Video","count":299},{"language":"es","tag":"Video","count":274},{"language":"es","tag":"Models","count":273},{"language":"ja","tag":"Models","count":273},{"language":"ko","tag":"Models","count":273},{"language":"zh","tag":"Models","count":273},{"language":"en","tag":"Models","count":271},{"language":"es","tag":"All Models","count":270},{"language":"en","tag":"All Models","count":268},{"language":"ja","tag":"画像","count":219},{"language":"ko","tag":"이미지","count":219},{"language":"zh","tag":"图像","count":219},{"language":"ja","tag":"Video","count":198},{"language":"zh","tag":"Video","count":198},{"language":"ko","tag":"Video","count":181}],"searchSettings":{"maxResults":10}},"assistantConfig":{"enableStarterQuestions":false},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":":root{--ink-900: #151417;--hub-shell-light: #f7f6f9;--accent-purple: #49378b;--accent-yellow: #f2ff59;--primary: 73 55 139 !important;--primary-light: 242 255 89 !important;--primary-dark: 242 255 89 !important}html.dark{--primary: 242 255 89 !important;--background-dark: 14 14 13 !important}html.dark body{background-color:#0e0e0d!important}html.dark #navbar,html.dark #navbar-transition{background-color:var(--ink-900)!important}html.dark #sidebar,html.dark #sidebar-content{background-color:rgb(var(--background-dark))!important}html.dark #navbar,html.dark #navbar-transition{box-shadow:none!important;filter:none!important;backdrop-filter:none!important;-webkit-backdrop-filter:none!important}html.dark #navbar-transition{border-bottom:1px solid rgba(255, 255, 255, 0.08)!important;opacity:1!important}html.dark img.nav-logo{filter:none}html.dark #sidebar-content a:not([aria-current=\"page\"]){color:rgba(255, 255, 255, 0.72)!important}html.dark #sidebar-content a:not([aria-current=\"page\"]) *{color:inherit!important}html.dark #sidebar-content a[aria-current=\"page\"]{color:var(--accent-yellow)!important;background-color:rgba(242, 255, 89, 0.10)!important}html.dark #sidebar-content a[aria-current=\"page\"] *{color:inherit!important}html.dark .nav-tabs-item[data-active],html.dark mobile-nav-tabs-item[data-active]{color:var(--accent-yellow)!important}html.dark #navbar a[href*=\"comfy.org/cloud\"] span.absolute{background-color:var(--accent-yellow)!important}html.dark #navbar a[href*=\"comfy.org/cloud\"] span.text-white{color:#151417!important}html:not(.dark) #background-color,html:not(.dark) #navbar,html:not(.dark) #navbar-transition,html:not(.dark) #sidebar,html:not(.dark) #sidebar-content{background-color:var(--hub-shell-light)!important}html:not(.dark) .nav-tabs-item[data-active],html:not(.dark) mobile-nav-tabs-item[data-active],html:not(.dark) nav-dropdown-item[data-active]{background-color:transparent!important;box-shadow:none!important;color:var(--accent-purple)!important;font-weight:600!important}html:not(.dark) .nav-tabs-item[data-active] *,html:not(.dark) mobile-nav-tabs-item[data-active] *,html:not(.dark) nav-dropdown-item[data-active] *{color:inherit!important}html:not(.dark) #sidebar-content li:has(>a[aria-current=\"page\"]){background-color:transparent!important;box-shadow:none!important}html:not(.dark) #sidebar-content a[aria-current=\"page\"]{color:var(--accent-purple)!important;background-color:rgba(73, 55, 139, 0.1)!important;font-weight:600!important}html:not(.dark) #sidebar-content a[aria-current=\"page\"] *{color:inherit!important}html:not(.dark) toc-item[data-active],html:not(.dark) toc-item[data-active-deepest],html:not(.dark) toc-item[data-active] a,html:not(.dark) toc-item[data-active-deepest] a{background-color:transparent!important;color:var(--accent-purple)!important;font-weight:600!important}html:not(.dark) #header :where(h1,h2,h3,h4,h5,h6),html:not(.dark) #content-area :where(h1,h2,h3,h4,h5,h6){color:#151417!important}html:not(.dark) #navbar a[href*=\"comfy.org/cloud\"]{background-color:transparent!important;color:var(--accent-purple)!important;border-radius:0.75rem;box-shadow:inset 0 0 0 1px var(--accent-purple)!important}html:not(.dark) #navbar a[href*=\"comfy.org/cloud\"] span.absolute{background-color:transparent!important}html:not(.dark) #navbar a[href*=\"comfy.org/cloud\"] *{color:inherit!important}#sidebar .sticky.top-0.pointer-events-none.bg-linear-to-b{background-image:none!important}@media (min-width: 1024px){#navbar.is-not-custom.is-not-center+div:has(>#sidebar),.max-w-8xl.mx-auto.relative,.max-w-8xl.mx-auto{max-width:none!important;width:100%!important;margin-left:0!important;margin-right:0!important;padding-left:0!important;padding-right:0!important}#navbar [class*=\"px-12\"],#navbar [class*=\"mx-4\"]{padding-left:0!important;padding-right:1.5rem!important;margin-left:0!important;margin-right:0!important}#navbar a.select-none,#navbar .nav-logo{margin-left:1rem!important}#navbar .nav-tabs{padding-left:2rem!important}#sidebar{left:0!important;margin-left:0!important;box-shadow:none!important}#sidebar-content{margin-left:0!important;padding-left:1rem!important;box-sizing:border-box!important}#navbar,#navbar-transition{left:0!important;right:0!important;width:100%!important;max-width:none!important}#content-area{margin-left:0!important;max-width:none!important;width:100%!important;padding-left:18rem!important}#sidebar.sticky~#content-container #content-area{padding-left:2rem!important;padding-right:2rem!important}#content-container,#body-content{max-width:none!important;width:100%!important}:root{--content-width: 100%;--sidebar-width: 18rem}}@media (min-width: 1024px){nav#sidebar,#sidebar[style]{left:0!important;right:auto!important;margin-left:0!important;transform:none!important}#navbar li.navbar-link:has(a[href*=\"comfy.org/download\"]){margin-right:0!important}#navbar a[href*=\"comfy.org/download\"]{box-sizing:border-box;border:1px solid rgb(255 255 255 / 0.22);border-radius:0.75rem;padding:7px 0.875rem!important;color:#fff!important;font-size:0.875rem;line-height:1.25rem}html:not(.dark) #navbar a[href*=\"comfy.org/download\"]{border-color:rgb(0 0 0 / 0.16);color:#151417!important}#navbar a[href*=\"comfy.org/download\"]:hover{background:rgb(255 255 255 / 0.06)}html:not(.dark) #navbar a[href*=\"comfy.org/download\"]:hover{background:rgb(0 0 0 / 0.04)}#navbar li.navbar-link:has(a[href*=\"comfy.org/download\"])+.whitespace-nowrap,#navbar .flex.space-x-6>.whitespace-nowrap.hidden{margin-left:0.5rem!important}}body:has(.router-api-reference-marker) #content,body:has(.router-api-reference-marker) #header{max-width:48rem}body:has(.router-api-reference-marker) #content-area table{width:100%;table-layout:auto}body:has(.router-api-reference-marker) #content-area th,body:has(.router-api-reference-marker) #content-area td{min-width:4rem!important;overflow-wrap:anywhere}body:has(.router-api-reference-marker) #content-area table:has(th:nth-child(6)) th:nth-child(3),body:has(.router-api-reference-marker) #content-area table:has(th:nth-child(6)) td:nth-child(3){min-width:5rem!important}@media (max-width: 1535px){body:has(.router-api-reference-marker) #content-side-layout{display:none!important}}body:has(.router-provider-coverage-marker) #content,body:has(.router-provider-coverage-marker) #header{max-width:64rem}body:has(.router-provider-coverage-marker) #content-area table{width:100%;table-layout:auto}body:has(.router-provider-coverage-marker) #content-area th,body:has(.router-provider-coverage-marker) #content-area td{min-width:5rem!important;overflow-wrap:anywhere}body:has(.router-provider-coverage-marker) #content-area th:first-child,body:has(.router-provider-coverage-marker) #content-area td:first-child{min-width:12rem!important}body:has(.router-quickstart-marker) [data-component-part=\"card-content\"] [data-component-part=\"code-block-root\"][style*=\"height:190px\"],body:has(.router-quickstart-marker) [data-component-part=\"card-content\"] [data-component-part=\"code-block-root\"][style*=\"height: 190px\"]{height:86px!important}#content img:not([data-component-part=\"card-image\"]){max-width:min(100%, 750px)}#content .frame:has(img){max-width:calc(750px + 1rem)}"},{"filePath":"samples-cards.css","content":".sample-card-grid{display:grid;gap:20px;grid-template-columns:repeat(2, minmax(0, 1fr));margin-top:28px}.sample-card{min-width:0;perspective:1200px}.sample-card-inner{height:565px;position:relative;transform-style:preserve-3d;transition:transform 560ms cubic-bezier(.2, .75, .3, 1)}.sample-card[data-flipped=\"true\"] .sample-card-inner{transform:rotateY(180deg)}.sample-card-face{backface-visibility:hidden;background:#fff;border:1px solid #e5e1eb;border-radius:12px;box-sizing:border-box;height:100%;inset:0;overflow:hidden;position:absolute;width:100%}.sample-card-front{display:flex;flex-direction:column}.sample-card-back{opacity:0;pointer-events:none;transform:rotateY(180deg);visibility:hidden}.sample-card[data-flipped=\"true\"] .sample-card-front{pointer-events:none;transition:visibility 0s linear 280ms;visibility:hidden}.sample-card[data-flipped=\"true\"][data-active-path=\"api\"] .sample-card-back[data-sample-path=\"api\"],.sample-card[data-flipped=\"true\"][data-active-path=\"endpoint\"] .sample-card-back[data-sample-path=\"endpoint\"]{opacity:1;pointer-events:auto;visibility:visible}.sample-card-preview{border-bottom:1px solid #e5e1eb;cursor:pointer;display:block;width:100%}.sample-card-body{display:flex;flex:1;flex-direction:column;padding:20px}.sample-card-body h2,.sample-path-body h2{color:#49378b;font-size:18px;font-weight:700;letter-spacing:-.02em;margin:0 0 8px}.sample-path-body h2{text-align:center}.sample-card-body>p{color:#5f5966;font-size:14px;line-height:1.55;margin:0;min-height:66px}.sample-card-actions{display:flex;gap:8px;margin-top:20px}.sample-card-actions button{background:#fff;border:1px solid #cfc8de;border-radius:6px;color:#49378b;cursor:pointer;flex:1;font-size:13px;font-weight:700;padding:10px 12px}.sample-card-links{border-top:1px solid #eeeaf1;display:flex;gap:8px;margin-top:16px;padding-top:12px}.sample-card-links a{color:#625b6c;font-size:12px;font-weight:650;text-decoration:none}.sample-card-links span{color:#b3adba}.sample-path-body{padding:20px}.sample-path-body>button{background:transparent;border:0;color:#625b6c;cursor:pointer;font-size:12px;font-weight:700;padding:0}.sample-path-eyebrow{color:#857a9e;font-size:10px;font-weight:700;letter-spacing:.08em;margin:19px 0 5px;text-align:center;text-transform:uppercase}.sample-path-body>p:not(.sample-path-eyebrow){color:#5f5966;font-size:12px;line-height:1.5;margin:0 0 15px}.sample-path-steps{display:grid;gap:8px}.sample-path-step{align-items:center;background:#faf9fc;border:1px solid #e5e1ea;border-radius:8px;display:flex;gap:10px;padding:10px 11px}.sample-path-number{align-items:center;background:#49378b;border-radius:999px;color:#fff;display:inline-flex;flex:0 0 21px;font-size:11px;font-weight:700;height:21px;justify-content:center}.sample-path-copy{flex:1;min-width:0}.sample-path-copy strong{color:#312c36;display:block;font-size:12px}.sample-path-copy span{color:#706a75;display:block;font-size:11px;line-height:1.35;margin-top:2px}.sample-path-step a{color:#49378b;flex:0 0 auto;font-size:11px;font-weight:700;text-decoration:none}@media (max-width: 768px){.sample-card-grid{grid-template-columns:1fr}.sample-card-inner{height:clamp(620px, 180vw, 760px)}}"}],"page":{"pagePath":"ko/custom-nodes/backend/datatypes","slug":"/ko/custom-nodes/backend/datatypes","pageMetadata":{"title":"ComfyUI 커스텀 노드 데이터 타입","sidebarTitle":"데이터 유형","description":"ComfyUI 커스텀 노드 데이터 타입 레퍼런스: Python 타입, 텐서 형식(IMAGE, LATENT, MASK), 커스텀 타입, INPUT_TYPES의 와일드카드.","translationSourceHash":"f04aba65","translationFrom":"custom-nodes/backend/datatypes.mdx","translationBlockHashes":{"_intro":"80373b23","Comfy datatypes":"fcd90f30","Python datatypes":"37b2f2ea","Tensor datatypes":"cfddd57a","Custom Sampling datatypes":"3f4ac4eb","Model datatypes":"26b3c960","Additional Parameters":"cd3afb90"},"href":"/ko/custom-nodes/backend/datatypes"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"ComfyUI 커스텀 노드 데이터 타입 레퍼런스: Python 타입, 텐서 형식(IMAGE, LATENT, MASK), 커스텀 타입, INPUT_TYPES의 와일드카드.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,li:`li`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Tip,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`다음은 가장 중요한 내장 데이터 타입입니다. 또한 `,_jsx(_components.a,{href:`/ko/custom-nodes/backend/more_on_inputs#%EB%A7%9E%EC%B6%A4%ED%98%95-%EB%8D%B0%EC%9D%B4%ED%84%B0-%ED%83%80%EC%9E%85`,children:`자신만의 데이터 타입을 정의`}),`할 수도 있습니다.`]}),`\n`,_jsx(_components.p,{children:`데이터 타입은 클라이언트 측에서 워크플로우가 잘못된 형태의 데이터를 노드에 전달하는 것을 방지하는 데 사용됩니다—강력한 타이핑과 비슷합니다.\nJavaScript 클라이언트 측 코드는 일반적으로 노드 출력을 다른 데이터 타입의 입력에 연결하지 못하도록 합니다.\n다만 아래에 몇 가지 예외 사항이 나와 있습니다.`}),`\n`,_jsx(Heading,{level:`2`,id:`comfy-데이터-타입`,children:`Comfy 데이터 타입`}),`\n`,_jsx(Heading,{level:`3`,id:`combo`,children:`COMBO`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`INPUT_TYPES`}),`에 추가적인 파라미터 없음`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Python 데이터 타입: `,_jsx(_components.code,{children:`list[str]`}),`로 정의되며, 출력 값은 `,_jsx(_components.code,{children:`str`}),`입니다.`]}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`드롭다운 메뉴 위젯을 나타냅니다.\n다른 데이터 타입과 달리, `,_jsx(_components.code,{children:`COMBO`}),`는 `,_jsx(_components.code,{children:`INPUT_TYPES`}),`에서 `,_jsx(_components.code,{children:`str`}),`로 지정되지 않고 드롭다운 목록의 옵션에 해당하는 `,_jsx(_components.code,{children:`list[str]`}),`로 지정되며, 기본적으로 첫 번째 옵션이 선택됩니다.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`COMBO`}),` 입력은 종종 런타임에 동적으로 생성됩니다. 예를 들어 내장된 `,_jsx(_components.code,{children:`CheckpointLoaderSimple`}),` 노드에서는 다음과 같이 찾을 수 있습니다:`]}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`\"ckpt_name\": (folder_paths.get_filename_list(\"checkpoints\"), )`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`또는 고정된 옵션 목록일 수도 있습니다:`}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`\"play_sound\": ([\"no\",\"yes\"], {}),`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`3`,id:`프리미티브-및-리루트`,children:`프리미티브 및 리루트`}),`\n`,_jsxs(_components.p,{children:[`프리미티브 및 리루트 노드는 클라이언트 측에만 존재합니다. 이들은 본질적인 데이터 타입을 갖지 않지만, 연결될 때 연결된 입력이나 출력의 데이터 타입을 따릅니다(그래서 `,_jsx(_components.code,{children:`*`}),` 입력에 연결할 수 없는 것입니다…).`]}),`\n`,_jsx(Heading,{level:`2`,id:`python-데이터-타입`,children:`Python 데이터 타입`}),`\n`,_jsx(Heading,{level:`3`,id:`int`,children:`INT`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`INPUT_TYPES`}),`에 추가적인 파라미터:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`default`}),`는 필수입니다.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`min`}),`과 `,_jsx(_components.code,{children:`max`}),`는 선택적입니다.`]}),`\n`]}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Python 데이터 타입 `,_jsx(_components.code,{children:`int`})]}),`\n`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`float`,children:`FLOAT`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`INPUT_TYPES`}),`에 추가적인 파라미터:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`default`}),`는 필수입니다.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`min`}),`, `,_jsx(_components.code,{children:`max`}),`, `,_jsx(_components.code,{children:`step`}),`는 선택적입니다.`]}),`\n`]}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Python 데이터 타입 `,_jsx(_components.code,{children:`float`})]}),`\n`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`string`,children:`STRING`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`INPUT_TYPES`}),`에 추가적인 파라미터:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`default`}),`는 필수입니다.`]}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Python 데이터 타입 `,_jsx(_components.code,{children:`str`})]}),`\n`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`boolean`,children:`BOOLEAN`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`INPUT_TYPES`}),`에 추가적인 파라미터:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`default`}),`는 필수입니다.`]}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Python 데이터 타입 `,_jsx(_components.code,{children:`bool`})]}),`\n`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`텐서-데이터-타입`,children:`텐서 데이터 타입`}),`\n`,_jsx(Heading,{level:`3`,id:`image`,children:`IMAGE`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`INPUT_TYPES`}),`에 추가적인 파라미터 없음`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Python 데이터 타입 `,_jsx(_components.code,{children:`torch.Tensor`}),`이며, `,_jsx(_components.em,{children:`shape`}),`는 [B,H,W,C]입니다.`]}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`B`}),`개의 이미지, 높이 `,_jsx(_components.code,{children:`H`}),`, 너비 `,_jsx(_components.code,{children:`W`}),`, 채널 수 `,_jsx(_components.code,{children:`C`}),`(일반적으로 `,_jsx(_components.code,{children:`RGB`}),`의 경우 `,_jsx(_components.code,{children:`C=3`}),`)의 배치입니다.`]}),`\n`,_jsx(Heading,{level:`3`,id:`latent`,children:`LATENT`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`INPUT_TYPES`}),`에 추가적인 파라미터 없음`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Python 데이터 타입 `,_jsx(_components.code,{children:`dict`}),`이며, `,_jsx(_components.em,{children:`shape`}),`는 [B,C,H,W]인 `,_jsx(_components.code,{children:`torch.Tensor`}),`를 포함합니다.`]}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`전달되는 `,_jsx(_components.code,{children:`dict`}),`에는 `,_jsx(_components.code,{children:`samples`}),`라는 키가 있으며, 이는 `,_jsx(_components.em,{children:`shape`}),` [B,C,H,W]인 `,_jsx(_components.code,{children:`torch.Tensor`}),`로, `,_jsx(_components.code,{children:`B`}),`개의 잠재 변수 배치를 나타내며, 채널 수는 `,_jsx(_components.code,{children:`C`}),`(일반적으로 기존 안정적 확산 모델의 경우 `,_jsx(_components.code,{children:`C=4`}),`), 높이 `,_jsx(_components.code,{children:`H`}),`, 너비 `,_jsx(_components.code,{children:`W`}),`입니다.`]}),`\n`,_jsx(_components.p,{children:`높이와 너비는 해당 이미지 크기의 1/8입니다(이는 Empty Latent Image 노드에서 설정한 값입니다).`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`dict`}),`의 다른 항목에는 잠재 마스크 같은 것이 포함됩니다.`]}),`\n`,_jsx(Heading,{level:`3`,id:`mask`,children:`MASK`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`INPUT_TYPES`}),`에 추가적인 파라미터 없음`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Python 데이터 타입 `,_jsx(_components.code,{children:`torch.Tensor`}),`이며, `,_jsx(_components.em,{children:`shape`}),`는 [H,W] 또는 [B,C,H,W]입니다.`]}),`\n`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`audio`,children:`AUDIO`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`INPUT_TYPES`}),`에 추가적인 파라미터 없음`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Python 데이터 타입 `,_jsx(_components.code,{children:`dict`}),`이며, `,_jsx(_components.em,{children:`shape`}),`는 [B, C, T]인 `,_jsx(_components.code,{children:`torch.Tensor`}),`와 샘플 속도를 포함합니다.`]}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`전달되는 `,_jsx(_components.code,{children:`dict`}),`에는 `,_jsx(_components.code,{children:`waveform`}),`이라는 키가 있으며, 이는 `,_jsx(_components.em,{children:`shape`}),` [B, C, T]인 `,_jsx(_components.code,{children:`torch.Tensor`}),`로, `,_jsx(_components.code,{children:`B`}),`개의 오디오 샘플 배치를 나타내며, 채널 수는 `,_jsx(_components.code,{children:`C`}),`(`,_jsx(_components.code,{children:`C=2`}),` 스테레오, `,_jsx(_components.code,{children:`C=1`}),` 모노), 시간 단계 수는 `,_jsx(_components.code,{children:`T`}),`입니다(즉, 오디오 샘플의 개수).`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`dict`}),`에는 또 다른 키인 `,_jsx(_components.code,{children:`sample_rate`}),`가 있으며, 이는 오디오의 샘플링 속도를 나타냅니다.`]}),`\n`,_jsx(Heading,{level:`2`,id:`맞춤형-샘플링-데이터-타입`,children:`맞춤형 샘플링 데이터 타입`}),`\n`,_jsx(Heading,{level:`3`,id:`noise`,children:`Noise`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`NOISE`}),` 데이터 타입은 노이즈의 `,_jsx(_components.em,{children:`소스`}),`를 나타냅니다(실제 노이즈 자체가 아님). 이는 `,_jsx(_components.code,{children:`generate_noise(self, input_latent:Tensor) -> Tensor`}),` 시그니처를 가진 노이즈 생성 메서드와 `,_jsx(_components.code,{children:`seed:Optional[int]`}),` 속성을 제공하는 모든 Python 객체로 표현될 수 있습니다.`]}),`\n`,_jsxs(Tip,{children:[` `,_jsx(_components.code,{children:`seed`}),`는 `,_jsx(_components.code,{children:`SamplerCustomAdvanced`}),`의 `,_jsx(_components.code,{children:`sample`}),` 가이더에 전달되지만, 표준 가이더에서는 사용되지 않는 것으로 보입니다. 이는 선택적이므로 일반적으로 None으로 설정할 수 있습니다.`]}),`\n`,_jsxs(_components.p,{children:[`노이즈를 추가할 때, 잠재 변수가 이 메서드에 전달되며, 이는 동일한 shape의 노이즈를 포함한 `,_jsx(_components.code,{children:`Tensor`}),`를 반환해야 합니다.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/ko/custom-nodes/backend/snippets#%EB%85%B8%EC%9D%B4%EC%A6%88-%EB%B3%80%ED%98%95-%EC%83%9D%EC%84%B1%ED%95%98%EA%B8%B0`,children:`노이즈 혼합 예시`}),` 참조`]}),`\n`,_jsx(Heading,{level:`3`,id:`sampler`,children:`Sampler`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`SAMPLER`}),` 데이터 타입은 샘플러를 나타내며, 이는 `,_jsx(_components.code,{children:`sample`}),` 메서드를 제공하는 Python 객체로 표현됩니다. 안정적 확산 샘플링은 이 가이드의 범위를 벗어납니다; 이 코드 부분을 자세히 살펴보려면 `,_jsx(_components.code,{children:`comfy/samplers.py`}),`를 참고하세요.`]}),`\n`,_jsx(Heading,{level:`3`,id:`sigmas`,children:`Sigmas`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`SIGMAS`}),` 데이터 타입은 스케줄러가 생성한 샘플링 과정의 각 단계 전후의 시그마 값을 나타냅니다. 이는 길이가 `,_jsx(_components.code,{children:`steps+1`}),`인 1차원 텐서로, 각 요소는 해당 단계 전에 존재할 것으로 예상되는 노이즈를 나타내며, 마지막 값은 최종 단계 이후의 노이즈를 나타냅니다.`]}),`\n`,_jsxs(_components.p,{children:[`20단계와 1의 디노이즈를 가진 `,_jsx(_components.code,{children:`normal`}),` 스케줄러는 SDXL 모델에서 다음과 같은 값을 생성합니다:`]}),`\n`,_jsx(CodeBlock,{numberOfLines:`5`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`tensor([14.6146, 10.7468, 8.0815, 6.2049, 4.8557, `})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` 3.8654, 3.1238, 2.5572, 2.1157, 1.7648, `})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` 1.4806, 1.2458, 1.0481, 0.8784, 0.7297, `})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` 0.5964, 0.4736, 0.3555, 0.2322, 0.0292, 0.0000])`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(Tip,{children:[`시그마의 시작값은 모델에 따라 다르므로, 스케줄러 노드는 SIGMAS 출력을 생성하려면 `,_jsx(_components.code,{children:`MODEL`}),` 입력이 필요합니다`]}),`\n`,_jsx(Heading,{level:`3`,id:`guider`,children:`Guider`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`GUIDER`}),`는 ‘안내’된 프롬프트나 기타 조건부 형태에 의해 ‘유도’된 디노이징 과정의 일반화입니다. Comfy에서 가이더는 `,_jsx(_components.code,{children:`callable`}),` Python 객체로 표현되며, `,_jsx(_components.code,{children:`__call__(*args, **kwargs)`}),` 메서드를 제공하고 이 메서드는 샘플에 의해 호출됩니다.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`__call__`}),` 메서드는 (`,_jsx(_components.code,{children:`args[0]`}),`에) 노이즈가 있는 잠재 변수 배치(`,_jsx(_components.code,{children:`tensor `}),`[B,C,H,W]`,_jsx(_components.code,{children:`)를 받아들여, 동일한 shape의 노이즈 예측값(`}),\"Tensor`)을 반환합니다.\"]}),`\n`,_jsx(Heading,{level:`2`,id:`모델-데이터-타입`,children:`모델 데이터 타입`}),`\n`,_jsxs(_components.p,{children:[`안정적 확산 모델을 위한 더 많은 기술적 데이터 타입이 있습니다. 가장 중요한 것은 `,_jsx(_components.code,{children:`MODEL`}),`, `,_jsx(_components.code,{children:`CLIP`}),`, `,_jsx(_components.code,{children:`VAE`}),`, 그리고 `,_jsx(_components.code,{children:`CONDITIONING`}),`입니다. 이들과 함께 작업하는 것은 (당분간) 이 가이드의 범위를 벗어납니다! `]}),`\n`,_jsx(Heading,{level:`2`,id:`추가-파라미터`,children:`추가 파라미터`}),`\n`,_jsx(_components.p,{children:`아래는 입력 정의의 ‘추가 옵션’ 부분에서 사용할 수 있는 공식 지원 키들의 목록입니다.`}),`\n`,_jsx(Warning,{children:`자신만의 맞춤 위젯을 위해 추가 키를 사용할 수 있지만, 아래 키들을 다른 용도로 재사용해서는 안 됩니다.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`키`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`default`})}),_jsx(_components.td,{children:`위젯의 기본값`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`min`})}),_jsxs(_components.td,{children:[`숫자(`,_jsx(_components.code,{children:`FLOAT`}),` 또는 `,_jsx(_components.code,{children:`INT`}),`)의 최소값`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`max`})}),_jsxs(_components.td,{children:[`숫자(`,_jsx(_components.code,{children:`FLOAT`}),` 또는 `,_jsx(_components.code,{children:`INT`}),`)의 최대값`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`step`})}),_jsx(_components.td,{children:`위젯을 증가하거나 감소시키는 양`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`label_on`})}),_jsxs(_components.td,{children:[`bool이 `,_jsx(_components.code,{children:`True`}),`일 때 UI에 사용할 라벨(`,_jsx(_components.code,{children:`BOOL`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`label_off`})}),_jsxs(_components.td,{children:[`bool이 `,_jsx(_components.code,{children:`False`}),`일 때 UI에 사용할 라벨(`,_jsx(_components.code,{children:`BOOL`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`defaultInput`})}),_jsx(_components.td,{children:`지원되는 위젯 대신 입력 소켓을 기본값으로 사용합니다`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`forceInput`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`defaultInput`}),`와 동시에 위젯으로 변환하는 것을 허용하지 않습니다`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`multiline`})}),_jsxs(_components.td,{children:[`다중행 텍스트 박스(`,_jsx(_components.code,{children:`STRING`}),`)를 사용합니다`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`placeholder`})}),_jsxs(_components.td,{children:[`비어 있을 때 UI에 표시할 자리표시 텍스트(`,_jsx(_components.code,{children:`STRING`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`dynamicPrompts`})}),_jsx(_components.td,{children:`프론트엔드가 동적 프롬프트를 평가하도록 만듭니다`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`lazy`})}),_jsxs(_components.td,{children:[`이 입력이 `,_jsx(_components.a,{href:`/ko/custom-nodes/backend/lazy_evaluation`,children:`지연 평가`}),`를 사용한다고 선언합니다`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`rawLink`})}),_jsxs(_components.td,{children:[`링크가 존재할 때, 평가된 값을 받는 대신 링크를 받게 됩니다(예: `,_jsx(_components.code,{children:`[\"nodeId\", \u003coutputIndex>]`}),`). 주로 노드가 `,_jsx(_components.a,{href:`/ko/custom-nodes/backend/expansion`,children:`노드 확장`}),`을 사용할 때 유용합니다.`]})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"ComfyUI 커스텀 노드 데이터 타입","sidebarTitle":"데이터 유형","description":"ComfyUI 커스텀 노드 데이터 타입 레퍼런스: Python 타입, 텐서 형식(IMAGE, LATENT, MASK), 커스텀 타입, INPUT_TYPES의 와일드카드.","translationSourceHash":"f04aba65","translationFrom":"custom-nodes/backend/datatypes.mdx","translationBlockHashes":{"_intro":"80373b23","Comfy datatypes":"fcd90f30","Python datatypes":"37b2f2ea","Tensor datatypes":"cfddd57a","Custom Sampling datatypes":"3f4ac4eb","Model datatypes":"26b3c960","Additional Parameters":"cd3afb90"},"href":"/ko/custom-nodes/backend/datatypes"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Comfy 데이터 타입","slug":"comfy-데이터-타입","depth":2,"children":[{"title":"COMBO","slug":"combo","depth":3,"children":[]},{"title":"프리미티브 및 리루트","slug":"프리미티브-및-리루트","depth":3,"children":[]}]},{"title":"Python 데이터 타입","slug":"python-데이터-타입","depth":2,"children":[{"title":"INT","slug":"int","depth":3,"children":[]},{"title":"FLOAT","slug":"float","depth":3,"children":[]},{"title":"STRING","slug":"string","depth":3,"children":[]},{"title":"BOOLEAN","slug":"boolean","depth":3,"children":[]}]},{"title":"텐서 데이터 타입","slug":"텐서-데이터-타입","depth":2,"children":[{"title":"IMAGE","slug":"image","depth":3,"children":[]},{"title":"LATENT","slug":"latent","depth":3,"children":[]},{"title":"MASK","slug":"mask","depth":3,"children":[]},{"title":"AUDIO","slug":"audio","depth":3,"children":[]}]},{"title":"맞춤형 샘플링 데이터 타입","slug":"맞춤형-샘플링-데이터-타입","depth":2,"children":[{"title":"Noise","slug":"noise","depth":3,"children":[]},{"title":"Sampler","slug":"sampler","depth":3,"children":[]},{"title":"Sigmas","slug":"sigmas","depth":3,"children":[]},{"title":"Guider","slug":"guider","depth":3,"children":[]}]},{"title":"모델 데이터 타입","slug":"모델-데이터-타입","depth":2,"children":[]},{"title":"추가 파라미터","slug":"추가-파라미터","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/dripart/9d6bf2b2531e904c/giscus-comments.js","/_mintlify/custom/dripart/bd0341946f3c75a6/syft.js","/_mintlify/custom/dripart/042392a43b5e681e/samples-cards.js"],"subdomain":"dripart","siteName":"ComfyUI","title":"ComfyUI 커스텀 노드 데이터 타입 - ComfyUI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/custom-nodes/backend/datatypes","matchLevel":1},"zh":{"href":"/zh/custom-nodes/backend/datatypes","matchLevel":1},"ja":{"href":"/ja/custom-nodes/backend/datatypes","matchLevel":1},"ko":{"href":"/ko/custom-nodes/backend/datatypes","matchLevel":0},"es":{"href":"/es/custom-nodes/backend/datatypes","matchLevel":1}}},"lastModified":"2026-11-11T23:14:33.448Z","originalFileLocation":"ko/custom-nodes/backend/datatypes.mdx","locale":"ko"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"ComfyUI 커스텀 노드 데이터 타입 레퍼런스: Python 타입, 텐서 형식(IMAGE, LATENT, MASK), 커스텀 타입, INPUT_TYPES의 와일드카드.\">\u003cmeta data-mint-head name=\"application-name\" content=\"ComfyUI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/dripart/lS3H5I41bE6LSXEf/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/dripart/lS3H5I41bE6LSXEf/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/dripart/lS3H5I41bE6LSXEf/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/dripart/lS3H5I41bE6LSXEf/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/dripart/lS3H5I41bE6LSXEf/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/dripart/lS3H5I41bE6LSXEf/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/dripart/lS3H5I41bE6LSXEf/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/dripart/lS3H5I41bE6LSXEf/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/dripart/lS3H5I41bE6LSXEf/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"ComfyUI 커스텀 노드 데이터 타입 - ComfyUI\">\u003cmeta data-mint-head property=\"og:description\" content=\"ComfyUI 커스텀 노드 데이터 타입 레퍼런스: Python 타입, 텐서 형식(IMAGE, LATENT, MASK), 커스텀 타입, INPUT_TYPES의 와일드카드.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ComfyUI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.comfy.org/ko/custom-nodes/backend/datatypes\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://dripart.mintlify.site/_mintlify/api/og/v2?division=Python+%28%EB%B0%B1%EC%97%94%EB%93%9C%29\u0026amp;title=ComfyUI+%EC%BB%A4%EC%8A%A4%ED%85%80+%EB%85%B8%EB%93%9C+%EB%8D%B0%EC%9D%B4%ED%84%B0+%ED%83%80%EC%9E%85\u0026amp;description=ComfyUI+%EC%BB%A4%EC%8A%A4%ED%85%80+%EB%85%B8%EB%93%9C+%EB%8D%B0%EC%9D%B4%ED%84%B0+%ED%83%80%EC%9E%85+%EB%A0%88%ED%8D%BC%EB%9F%B0%EC%8A%A4%3A+Python+%ED%83%80%EC%9E%85%2C+%ED%85%90%EC%84%9C+%ED%98%95%EC%8B%9D%28IMAGE%2C+LATENT%2C+MASK%29%2C+%EC%BB%A4%EC%8A%A4%ED%85%80+%ED%83%80%EC%9E%85%2C+INPUT_TYPES%EC%9D%98+%EC%99%80%EC%9D%BC%EB%93%9C%EC%B9%B4%EB%93%9C.\u0026amp;theme=b252c39adf72ba65053766a0\u0026amp;signature=b6cdc0188eef7c4d26987cece24a05c40d5d6a775c1edb4d0263ec56cd16bc1f\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"ComfyUI 커스텀 노드 데이터 타입 - ComfyUI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"ComfyUI 커스텀 노드 데이터 타입 레퍼런스: Python 타입, 텐서 형식(IMAGE, LATENT, MASK), 커스텀 타입, INPUT_TYPES의 와일드카드.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://dripart.mintlify.site/_mintlify/api/og/v2?division=Python+%28%EB%B0%B1%EC%97%94%EB%93%9C%29\u0026amp;title=ComfyUI+%EC%BB%A4%EC%8A%A4%ED%85%80+%EB%85%B8%EB%93%9C+%EB%8D%B0%EC%9D%B4%ED%84%B0+%ED%83%80%EC%9E%85\u0026amp;description=ComfyUI+%EC%BB%A4%EC%8A%A4%ED%85%80+%EB%85%B8%EB%93%9C+%EB%8D%B0%EC%9D%B4%ED%84%B0+%ED%83%80%EC%9E%85+%EB%A0%88%ED%8D%BC%EB%9F%B0%EC%8A%A4%3A+Python+%ED%83%80%EC%9E%85%2C+%ED%85%90%EC%84%9C+%ED%98%95%EC%8B%9D%28IMAGE%2C+LATENT%2C+MASK%29%2C+%EC%BB%A4%EC%8A%A4%ED%85%80+%ED%83%80%EC%9E%85%2C+INPUT_TYPES%EC%9D%98+%EC%99%80%EC%9D%BC%EB%93%9C%EC%B9%B4%EB%93%9C.\u0026amp;theme=b252c39adf72ba65053766a0\u0026amp;signature=b6cdc0188eef7c4d26987cece24a05c40d5d6a775c1edb4d0263ec56cd16bc1f\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/dripart/lS3H5I41bE6LSXEf/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"ComfyUI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#49378B\">\u003cmeta data-mint-head name=\"googlebot\" content=\"max-video-preview:0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.comfy.org/ko/custom-nodes/backend/datatypes\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ko/custom-nodes/backend/datatypes.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.comfy.org/ko/custom-nodes/backend/datatypes\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.comfy.org/custom-nodes/backend/datatypes\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.comfy.org/zh/custom-nodes/backend/datatypes\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://docs.comfy.org/ja/custom-nodes/backend/datatypes\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.comfy.org/es/custom-nodes/backend/datatypes\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.comfy.org/custom-nodes/backend/datatypes\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.comfy.org/#organization\",\"name\":\"ComfyUI\",\"url\":\"https://docs.comfy.org\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/dripart/WCFdTagRdhtvk9-o/logo/light.svg?fit=max\u0026auto=format\u0026n=WCFdTagRdhtvk9-o\u0026q=85\u0026s=ec112de87239058f5a931a7e4b594965\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.comfy.org#website\",\"name\":\"ComfyUI\",\"url\":\"https://docs.comfy.org\",\"publisher\":{\"@id\":\"https://docs.comfy.org/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.comfy.org/ko/custom-nodes/backend/datatypes#webpage\",\"url\":\"https://docs.comfy.org/ko/custom-nodes/backend/datatypes\",\"name\":\"ComfyUI 커스텀 노드 데이터 타입\",\"description\":\"ComfyUI 커스텀 노드 데이터 타입 레퍼런스: Python 타입, 텐서 형식(IMAGE, LATENT, MASK), 커스텀 타입, INPUT_TYPES의 와일드카드.\",\"dateModified\":\"2026-11-11T23:14:33.448Z\",\"isPartOf\":{\"@id\":\"https://docs.comfy.org#website\"},\"breadcrumb\":{\"@id\":\"https://docs.comfy.org/ko/custom-nodes/backend/datatypes#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.comfy.org/ko/custom-nodes/backend/datatypes#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"커스텀 노드 구축\",\"item\":\"https://docs.comfy.org/ko/custom-nodes/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Python (백엔드)\",\"item\":\"https://docs.comfy.org/ko/custom-nodes/backend/server_overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"ComfyUI 커스텀 노드 데이터 타입\",\"item\":\"https://docs.comfy.org/ko/custom-nodes/backend/datatypes\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.comfy.org/ko/custom-nodes/backend/datatypes#article\",\"headline\":\"ComfyUI 커스텀 노드 데이터 타입\",\"name\":\"ComfyUI 커스텀 노드 데이터 타입\",\"description\":\"ComfyUI 커스텀 노드 데이터 타입 레퍼런스: Python 타입, 텐서 형식(IMAGE, LATENT, MASK), 커스텀 타입, INPUT_TYPES의 와일드카드.\",\"url\":\"https://docs.comfy.org/ko/custom-nodes/backend/datatypes\",\"mainEntityOfPage\":{\"@id\":\"https://docs.comfy.org/ko/custom-nodes/backend/datatypes#webpage\"},\"dateModified\":\"2026-11-11T23:14:33.448Z\",\"publisher\":{\"@id\":\"https://docs.comfy.org/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.comfy.org#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"ComfyUI\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"ComfyUI\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/ko/custom-nodes/backend/datatypes.md","siteName":"ComfyUI","nav":{"global":null,"languages":[{"language":"en","pages":[{"title":"en","href":"/custom-nodes/backend/datatypes"}]},{"language":"zh","footer":{"socials":{"github":"https://github.com/Comfy-Org/ComfyUI","x":"https://x.com/ComfyUI","discord":"https://discord.com/invite/comfyorg","youtube":"https://www.youtube.com/@comfyorg"},"links":[{"header":"资源","items":[{"label":"安装","href":"/zh/installation/system_requirements"},{"label":"教程","href":"/zh/tutorials/basic/text-to-image"},{"label":"开发","href":"/zh/development/overview"}]},{"header":"产品","items":[{"label":"功能","href":"https://www.comfy.org/?utm_source=docs"},{"label":"画廊","href":"https://www.comfy.org/gallery?utm_source=docs"},{"label":"下载","href":"https://www.comfy.org/download?utm_source=docs"}]},{"header":"公司","items":[{"label":"关于","href":"https://www.comfy.org/about?utm_source=docs"},{"label":"招聘","href":"https://www.comfy.org/careers?utm_source=docs"},{"label":"服务条款","href":"https://www.comfy.org/terms-of-service?utm_source=docs"},{"label":"隐私政策","href":"https://www.comfy.org/privacy-policy?utm_source=docs"}]}]},"pages":[{"title":"zh","href":"/zh/custom-nodes/backend/datatypes"}]},{"language":"ja","footer":{"socials":{"github":"https://github.com/Comfy-Org/ComfyUI","x":"https://x.com/ComfyUI","discord":"https://discord.com/invite/comfyorg","youtube":"https://www.youtube.com/@comfyorg"},"links":[{"header":"リソース","items":[{"label":"インストール","href":"/ja/installation/system_requirements"},{"label":"チュートリアル","href":"/ja/tutorials/basic/text-to-image"},{"label":"開発","href":"/ja/development/overview"}]},{"header":"プロダクト","items":[{"label":"機能","href":"https://www.comfy.org/?utm_source=docs"},{"label":"ギャラリー","href":"https://www.comfy.org/gallery?utm_source=docs"},{"label":"ダウンロード","href":"https://www.comfy.org/download?utm_source=docs"}]},{"header":"会社情報","items":[{"label":"概要","href":"https://www.comfy.org/about?utm_source=docs"},{"label":"採用情報","href":"https://www.comfy.org/careers?utm_source=docs"},{"label":"利用規約","href":"https://www.comfy.org/terms-of-service?utm_source=docs"},{"label":"プライバシーポリシー","href":"https://www.comfy.org/privacy-policy?utm_source=docs"}]}]},"navbar":{"links":[{"href":"/ja/tutorials/partner-nodes/pricing","label":"料金"},{"href":"https://comfy.org/download?utm_source=docs","label":"ダウンロード"}],"primary":{"type":"button","label":"Comfy Cloud","href":"https://comfy.org/cloud?utm_source=docs"}},"pages":[{"title":"ja","href":"/ja/custom-nodes/backend/datatypes"}]},{"language":"ko","footer":{"socials":{"github":"https://github.com/Comfy-Org/ComfyUI","x":"https://x.com/ComfyUI","discord":"https://discord.com/invite/comfyorg","youtube":"https://www.youtube.com/@comfyorg"},"links":[{"header":"리소스","items":[{"label":"설치","href":"/ko/installation/system_requirements"},{"label":"튜토리얼","href":"/ko/tutorials/basic/text-to-image"},{"label":"개발","href":"/ko/development/overview"}]},{"header":"제품","items":[{"label":"기능","href":"https://www.comfy.org/?utm_source=docs"},{"label":"갤러리","href":"https://www.comfy.org/gallery?utm_source=docs"},{"label":"다운로드","href":"https://www.comfy.org/download?utm_source=docs"}]},{"header":"회사 정보","items":[{"label":"소개","href":"https://www.comfy.org/about?utm_source=docs"},{"label":"채용","href":"https://www.comfy.org/careers?utm_source=docs"},{"label":"이용약관","href":"https://www.comfy.org/terms-of-service?utm_source=docs"},{"label":"개인정보 처리방침","href":"https://www.comfy.org/privacy-policy?utm_source=docs"}]}]},"navbar":{"links":[{"href":"/ko/tutorials/partner-nodes/pricing","label":"가격 정책"},{"href":"https://comfy.org/download?utm_source=docs","label":"다운로드"}],"primary":{"type":"button","label":"Comfy Cloud","href":"https://comfy.org/cloud?utm_source=docs"}},"tabs":[{"tab":"시작하기","pages":[{"title":"시작하기","href":"/ko"}]},{"tab":"내장 노드 (Built-in Nodes)","pages":[{"title":"내장 노드 (Built-in Nodes)","href":"/ko/built-in-nodes/overview"}]},{"tab":"API 개발","pages":[{"title":"API 개발","href":"/ko/development/overview"}]},{"tab":"커스텀 노드","pages":[{"title":"ComfyUI 커스텀 노드 개발: 구축, 확장, 게시","sidebarTitle":"개요","href":"/ko/custom-nodes/intro"},{"group":"커스텀 노드 구축","pages":[{"title":"ComfyUI 커스텀 노드 유형과 구조","sidebarTitle":"노드 유형","href":"/ko/custom-nodes/overview"},{"title":"ComfyUI에서 커스텀 노드 만들기","sidebarTitle":"첫 노드 만들기","href":"/ko/custom-nodes/walkthrough"},{"group":"Python (백엔드)","pages":[{"title":"커스텀 노드 속성","sidebarTitle":"노드 속성","href":"/ko/custom-nodes/backend/server_overview"},{"title":"ComfyUI 커스텀 노드 라이프사이클","sidebarTitle":"노드 수명 주기","description":"ComfyUI가 커스텀 노드를 로드하는 과정을 설명합니다. __init__.py 임포트, NODE_CLASS_MAPPINGS, NODE_DISPLAY_NAME_MAPPINGS, 클라이언트 측 JavaScript용 WEB_DIRECTORY를 다룹니다.","href":"/ko/custom-nodes/backend/lifecycle"},{"title":"ComfyUI 커스텀 노드 데이터 타입","sidebarTitle":"데이터 유형","href":"/ko/custom-nodes/backend/datatypes"},{"title":"이미지, 랜트, 마스크","description":"ComfyUI 커스텀 노드 백엔드에서 이미지와 마스크 데이터 처리를 익히세요. PyTorch 텐서 형태, PIL 변환, 레이턴트를 배웁니다.","sidebarTitle":"이미지, 랜트, 마스크","href":"/ko/custom-nodes/backend/images_and_masks"},{"title":"숨겨진 및 유연한 입력","sidebarTitle":"숨겨진 및 유연한 입력","href":"/ko/custom-nodes/backend/more_on_inputs"},{"title":"지연 평가: ComfyUI 커스텀 노드 입력 평가","sidebarTitle":"지연 평가","href":"/ko/custom-nodes/backend/lazy_evaluation"},{"title":"노드 확장","href":"/ko/custom-nodes/backend/expansion"},{"title":"ComfyUI 데이터 목록과 목록 처리","sidebarTitle":"리스트 및 리스트 처리","href":"/ko/custom-nodes/backend/lists"},{"title":"torch.Tensor와 함께 작업하기","sidebarTitle":"텐서","href":"/ko/custom-nodes/backend/tensors"},{"title":"ComfyUI 커스텀 노드 Python 스니펫","sidebarTitle":"Python 스니펫","href":"/ko/custom-nodes/backend/snippets"},{"title":"실행 모델 반전 가이드","sidebarTitle":"실행 모델","icon":"code-branch","href":"/ko/development/comfyui-server/execution_model_inversion_guide"}]},{"group":"JavaScript (UI)","pages":[{"title":"JavaScript 확장기능","sidebarTitle":"JavaScript 확장","href":"/ko/custom-nodes/js/javascript_overview"},{"title":"ComfyUI JavaScript 후크","sidebarTitle":"훅","href":"/ko/custom-nodes/js/javascript_hooks"},{"title":"컴피 오브젝트","href":"/ko/custom-nodes/js/javascript_objects_and_hijacking"},{"title":"설정 API","href":"/ko/custom-nodes/js/javascript_settings"},{"title":"ComfyUI 대화 API","sidebarTitle":"대화상자 API","href":"/ko/custom-nodes/js/javascript_dialog"},{"title":"ComfyUI Toast API","sidebarTitle":"토스트 API","href":"/ko/custom-nodes/js/javascript_toast"},{"title":"패널 배지에 대하여","href":"/ko/custom-nodes/js/javascript_about_panel_badges"},{"title":"하단 패널 탭","href":"/ko/custom-nodes/js/javascript_bottom_panel_tabs"},{"title":"사이드바 탭","href":"/ko/custom-nodes/js/javascript_sidebar_tabs"},{"title":"선택 도구 상자","href":"/ko/custom-nodes/js/javascript_selection_toolbox"},{"title":"명령어 및 키바인딩","href":"/ko/custom-nodes/js/javascript_commands_keybindings"},{"title":"ComfyUI 탑바 메뉴 API","sidebarTitle":"상단 메뉴 API","href":"/ko/custom-nodes/js/javascript_topbar_menu"},{"title":"ComfyUI 부그래프","sidebarTitle":"서브그래프","href":"/ko/custom-nodes/js/subgraphs"},{"title":"위젯과 커서를 위한 캔버스 포인터 API","sidebarTitle":"캔버스 포인터 API","href":"/ko/custom-nodes/js/canvas-pointer-api"},{"title":"커스텀 노드 JavaScript 예제: 메뉴, 이벤트, 훅","sidebarTitle":"JavaScript 예제","href":"/ko/custom-nodes/js/javascript_examples"}]},{"title":"ComfyUI 커스텀 노드 i18n: 노드 정의 현지화","sidebarTitle":"i18n 지원","href":"/ko/custom-nodes/i18n"},{"group":"마이그레이션 가이드","pages":[{"title":"ComfyUI 커스텀 노드 V3 마이그레이션: V1에서 V3 스키마로","href":"/ko/custom-nodes/v3_migration"},{"title":"컨텍스트 메뉴 API 마이그레이션: ComfyUI 캔버스 및 노드 메뉴","sidebarTitle":"컨텍스트 메뉴 마이그레이션","href":"/ko/custom-nodes/js/context-menu-migration"},{"title":"프론트엔드 확장 프로그램의 노드 ID 마이그레이션","sidebarTitle":"노드 ID 마이그레이션","href":"/ko/custom-nodes/js/node-id-migration"},{"title":"프런트엔드 확장의 링크 등록 마이그레이션","sidebarTitle":"링크 등록","href":"/ko/custom-nodes/js/link-registration-migration"},{"title":"프론트엔드 확장 프로그램을 위한 위젯 시스템 마이그레이션","sidebarTitle":"위젯 시스템 마이그레이션","href":"/ko/custom-nodes/js/widgets-migration"},{"title":"프론트엔드 확장 프로그램을 위한 연결 콜백 마이그레이션","sidebarTitle":"연결 콜백","href":"/ko/custom-nodes/js/connection-callbacks-migration"},{"title":"프런트엔드 확장 프로그램을 위한 직렬화 콜백 마이그레이션","sidebarTitle":"직렬화 콜백","href":"/ko/custom-nodes/js/serialization-callbacks-migration"},{"title":"프런트엔드 확장 프로그램의 노드 지오메트리 마이그레이션","sidebarTitle":"노드 지오메트리 마이그레이션","href":"/ko/custom-nodes/js/node-geometry-migration"},{"title":"프런트엔드 확장 프로그램을 위한 PrimeVue 제거 마이그레이션","sidebarTitle":"PrimeVue 제거","href":"/ko/custom-nodes/js/primevue-removal-migration"},{"title":"노드 교체","href":"/ko/custom-nodes/backend/node-replacement"}]}]},{"group":"패키지 및 게시","pages":[{"title":"ComfyUI 커스텀 노드 문서: Markdown 도움말 페이지","sidebarTitle":"노드 문서","href":"/ko/custom-nodes/help_page"},{"title":"워크플로 템플릿","href":"/ko/custom-nodes/workflow_templates"},{"title":"하위 그래프 블루프린트","href":"/ko/custom-nodes/subgraph_blueprints"},{"title":"Comfy Registry: 커스텀 노드 게시와 버전 관리","sidebarTitle":"Registry 개요","href":"/ko/registry/overview"},{"title":"Comfy Registry에 커스텀 노드 게시","sidebarTitle":"노드 게시","href":"/ko/registry/publishing"},{"title":"커스텀 노드를 ComfyUI Manager에 게시하기","sidebarTitle":"매니저에 게시하기","href":"/ko/custom-nodes/backend/manager"},{"title":"커스텀 노드 소유권 신청: Comfy Registry","sidebarTitle":"노드 신청","href":"/ko/registry/claim-my-node"},{"title":"Comfy Registry 노드 품질 및 보안 표준","sidebarTitle":"품질 및 보안 기준","href":"/ko/registry/standards"},{"title":"커스텀 노드 CI/CD","sidebarTitle":"CI/CD","href":"/ko/registry/cicd"},{"title":"pyproject.toml","href":"/ko/registry/specifications"},{"title":"API 개요","href":"/ko/registry/api-reference/overview"},{"group":"Registry API 참조","pages":[{"title":"Get information about the calling user.","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi get /users","href":"/ko/registry/api-reference/registry/get-information-about-the-calling-user"},{"title":"Retrieve all publishers for a given user","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi get /users/publishers/","href":"/ko/registry/api-reference/registry/retrieve-all-publishers-for-a-given-user"},{"title":"Validate if a publisher username is available","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi get /publishers/validate","href":"/ko/registry/api-reference/registry/validate-if-a-publisher-username-is-available"},{"title":"Create a new publisher","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi post /publishers","href":"/ko/registry/api-reference/registry/create-a-new-publisher"},{"title":"Retrieve all publishers","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi get /publishers","href":"/ko/registry/api-reference/registry/retrieve-all-publishers"},{"title":"Retrieve a publisher by ID","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi get /publishers/{publisherId}","href":"/ko/registry/api-reference/registry/retrieve-a-publisher-by-id"},{"title":"Update a publisher","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi put /publishers/{publisherId}","href":"/ko/registry/api-reference/registry/update-a-publisher"},{"title":"Delete a publisher","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi delete /publishers/{publisherId}","href":"/ko/registry/api-reference/registry/delete-a-publisher"},{"title":"Retrieve permissions the user has for a given publisher","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi get /publishers/{publisherId}/nodes/{nodeId}/permissions","href":"/ko/registry/api-reference/registry/retrieve-permissions-the-user-has-for-a-given-publisher"},{"title":"Create a new personal access token","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi post /publishers/{publisherId}/tokens","href":"/ko/registry/api-reference/registry/create-a-new-personal-access-token"},{"title":"Delete a specific personal access token","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi delete /publishers/{publisherId}/tokens/{tokenId}","href":"/ko/registry/api-reference/registry/delete-a-specific-personal-access-token"},{"title":"Retrieve all nodes","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi get /publishers/{publisherId}/nodes/v2","href":"/ko/registry/api-reference/registry/retrieve-all-nodes"},{"title":"Retrieve all nodes","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi get /publishers/{publisherId}/nodes/v2","href":"/ko/registry/api-reference/registry/retrieve-all-nodes"},{"title":"Create a new custom node","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi post /publishers/{publisherId}/nodes","href":"/ko/registry/api-reference/registry/create-a-new-custom-node"},{"title":"Update a specific node","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi put /publishers/{publisherId}/nodes/{nodeId}","href":"/ko/registry/api-reference/registry/update-a-specific-node"},{"title":"Delete a specific node","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi delete /publishers/{publisherId}/nodes/{nodeId}","href":"/ko/registry/api-reference/registry/delete-a-specific-node"},{"title":"Retrieve permissions the user has for a given publisher","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi get /publishers/{publisherId}/nodes/{nodeId}/permissions","href":"/ko/registry/api-reference/registry/retrieve-permissions-the-user-has-for-a-given-publisher"},{"title":"Claim nodeId into publisherId for the authenticated publisher","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi post /publishers/{publisherId}/nodes/{nodeId}/claim-my-node","href":"/ko/registry/api-reference/registry/claim-nodeid-into-publisherid-for-the-authenticated-publisher"},{"title":"Publish a new version of a node","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi post /publishers/{publisherId}/nodes/{nodeId}/versions","href":"/ko/registry/api-reference/registry/publish-a-new-version-of-a-node"},{"title":"Update changelog and deprecation status of a node version","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi put /publishers/{publisherId}/nodes/{nodeId}/versions/{versionId}","href":"/ko/registry/api-reference/registry/update-changelog-and-deprecation-status-of-a-node-version"},{"title":"Unpublish (delete) a specific version of a node","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi delete /publishers/{publisherId}/nodes/{nodeId}/versions/{versionId}","href":"/ko/registry/api-reference/registry/unpublish-delete-a-specific-version-of-a-node"},{"title":"Retrieves a list of nodes","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi get /nodes/search","href":"/ko/registry/api-reference/registry/retrieves-a-list-of-nodes"},{"title":"Retrieves a list of nodes","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi get /nodes/search","href":"/ko/registry/api-reference/registry/retrieves-a-list-of-nodes"},{"title":"Retrieve a specific node by ID","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi get /nodes/{nodeId}","href":"/ko/registry/api-reference/registry/retrieve-a-specific-node-by-id"},{"title":"Returns a node version to be installed.","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi get /nodes/{nodeId}/install","href":"/ko/registry/api-reference/registry/returns-a-node-version-to-be-installed"},{"title":"Add review to a specific version of a node","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi post /nodes/{nodeId}/reviews","href":"/ko/registry/api-reference/registry/add-review-to-a-specific-version-of-a-node"},{"title":"Create Node Translations","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi post /nodes/{nodeId}/translations","href":"/ko/registry/api-reference/registry/create-node-translations"},{"title":"List all versions of a node","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi get /nodes/{nodeId}/versions","href":"/ko/registry/api-reference/registry/list-all-versions-of-a-node"},{"title":"Retrieve a specific version of a node","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi get /nodes/{nodeId}/versions/{versionId}","href":"/ko/registry/api-reference/registry/retrieve-a-specific-version-of-a-node"},{"title":"Retrieve multiple node versions in a single request","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi post /bulk/nodes/versions","href":"/ko/registry/api-reference/registry/retrieve-multiple-node-versions-in-a-single-request"},{"title":"List all node versions given some filters.","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi get /versions","href":"/ko/registry/api-reference/registry/list-all-node-versions-given-some-filters"},{"title":"list all comfy-nodes","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi get /comfy-nodes","href":"/ko/registry/api-reference/registry/list-all-comfy-nodes"},{"title":"Retrieve a node by ComfyUI node name","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi get /comfy-nodes/{comfyNodeName}/node","href":"/ko/registry/api-reference/registry/retrieve-a-node-by-comfyui-node-name"},{"title":"create comfy-nodes for certain node","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi post /nodes/{nodeId}/versions/{version}/comfy-nodes","href":"/ko/registry/api-reference/registry/create-comfy-nodes-for-certain-node"},{"title":"list comfy-nodes for node version","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi get /nodes/{nodeId}/versions/{version}/comfy-nodes","href":"/ko/registry/api-reference/registry/list-comfy-nodes-for-node-version"},{"title":"get specify comfy-node based on its id","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi get /nodes/{nodeId}/versions/{version}/comfy-nodes/{comfyNodeName}","href":"/ko/registry/api-reference/registry/get-specify-comfy-node-based-on-its-id"},{"title":"Update a specific comfy-node","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi put /nodes/{nodeId}/versions/{version}/comfy-nodes/{comfyNodeName}","href":"/ko/registry/api-reference/registry/update-a-specific-comfy-node"},{"title":"Get server feature flags","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi get /features","href":"/ko/registry/api-reference/registry/get-server-feature-flags"},{"title":"Get release notes","deprecated":null,"version":null,"openapi":"https://api.comfy.org/openapi get /releases","href":"/ko/registry/api-reference/releases/get-release-notes"}]}]}]},{"tab":"지원","pages":[{"title":"지원","href":"/ko/support/contact-support"}]},{"tab":"Cloud API 참조","pages":[{"title":"Cloud API 참조","href":"/ko/api-reference/cloud/workflow/get-information-about-current-prompt-executions"}]}]},{"language":"es","pages":[{"title":"es","href":"/es/custom-nodes/backend/datatypes"}]}]},"basePath":"","title":"ComfyUI 커스텀 노드 데이터 타입 - ComfyUI","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":[],"chunks":[]}