API Reference

전체 ComfyUI node 정보 조회

설치된 모든 ComfyUI node class의 input·output 정의를 조회합니다.

GET/v1/api/comfy/object-info

요청 예제

bash

curl --request GET   --url "$NORDY_BASE_URL/v1/api/comfy/object-info"   --header "api-key: $NORDY_API_KEY"

성공 응답200 OK

JSON

{
  "CheckpointLoaderSimple": {
    "input": {
      "required": {
        "ckpt_name": [
          ["dreamshaper_8.safetensors"]
        ]
      }
    },
    "output": ["MODEL", "CLIP", "VAE"],
    "name": "CheckpointLoaderSimple"
  }
}

인증

api-keystring필수

사용자 API key를 api-key request header에 넣습니다.

파라미터

If-None-Matchstringheader선택: 변경 여부를 확인하려면 이전 응답의 ETag를 그대로 전달하세요.

성공 응답

200 OK

<className>objectresponse선택: ComfyUI node class의 input·output 정의입니다.

참고

설치된 노드·모델에 따라 정의가 달라지며, 목록에 있어도 Job에서 사용하지 못할 수 있습니다. Nordy ComfyUI에서 워크플로를 실행해 확인하세요.
응답에는 ETag, Content-Type, Cache-Control, Vary 헤더가 포함될 수 있습니다.

응답과 오류

Status	Code	설명
304	—	ETag가 일치하며 body는 없습니다.
400	MULTIPLE_AUTH_CREDENTIALS	로그인 쿠키를 제외하고 api-key header만 보내세요.
401	AUTHENTICATION_REQUIRED	API key가 없거나 일치하지 않습니다.
403	USER_SUSPENDED, PRO_SUBSCRIPTION_REQUIRED, INVALID_INPUT	계정이 정지되었거나, Pro 구독이 활성화되어 있지 않거나, API 이용이 제한된 상태입니다.
500	INTERNAL_ERROR	요청 처리 중 서버 오류가 발생했습니다.
502 / 504	INTERNAL_ERROR	서비스에 연결하지 못했거나 응답 대기 시간이 초과되었습니다.
Other	—	ComfyUI에서 반환하는 다른 상태 코드와 응답 본문이 포함될 수 있습니다.