ComfyUI 노드
SpicyAPI의 이미지·영상·오디오 모델(Seedance, Kling, Wan, MiniMax H3, Suno, GPT Image, Nano Banana 등)을 ComfyUI 노드로 실행하세요. 노드 팩을 설치하고 키를 등록한 뒤 첫 노드를 실행하고, 실행마다 드는 비용을 한눈에 확인합니다.
ComfyUI용 SpicyAPI 노드 팩은 SpicyAPI의 이미지·영상·오디오 모델을 하나하나 ComfyUI 노드로 만들어 줍니다. 그 수가 180개가 넘고, 텍스트 모델용 SpicyAPI Chat 노드와 SpicyAPI LoRA 노드도 함께 들어 있습니다. 모델은 SpicyAPI 서버에서 실행되므로 필요한 것은 인터넷 연결과 API 키뿐이고, 그래픽 카드도 내려받은 가중치 파일도 필요 없습니다. 각 노드는 실행하기 전에 가격을 보여 주고, 실행이 끝나면 실제로 든 비용을 출력합니다.
노드 팩은 무료 오픈 소스(MIT)이며 github.com/spicyapi-ai/comfyui-spicyapi에서 받을 수 있습니다. ComfyUI 자체 외에는 아무것도 추가로 설치하지 않습니다.
한눈에 보기
- ComfyUI에서 Manager를 열고
SpicyAPI를 검색해 Install을 누른 뒤 ComfyUI를 다시 시작하세요. Manager가 없다면ComfyUI/custom_nodes에서git clone https://github.com/spicyapi-ai/comfyui-spicyapi를 실행하면 됩니다. - Settings > SpicyAPI를 열어 API 키를 붙여 넣고, ComfyUI를 한 번 더 다시 시작하세요.
- 캔버스를 더블클릭하고
seedance나kling같은 모델 이름을 입력한 다음, 그 출력에 Save 노드를 연결하고 Run을 누르세요.
나에게 맞는 도구일까요?
| 하고 싶은 일 | 추천 도구 |
|---|---|
| 시각적 그래프에서 모델을 다른 ComfyUI 노드와 연결하기 | ComfyUI 노드(이 페이지) |
| 아무것도 설치하지 않고 브라우저에서 모델을 한 번 써 보기 | spicyapi.ai/explore에 있는 모든 모델의 플레이그라운드 탭 |
| 터미널이나 간단한 스크립트로 생성하기 | CLI |
| AI 어시스턴트가 모델을 둘러보고 대신 생성하게 하기 | MCP 서버 |
| 내 애플리케이션에 생성 기능 넣기 | SDK 또는 빠른 시작의 HTTP API |
어느 쪽이든 같은 계정, 같은 잔액, 같은 모델, 같은 가격을 씁니다.
시작하기 전에
- 최신 ComfyUI. 이 노드는 ComfyUI의 V3 노드 API를 쓰며 ComfyUI 0.39에서 테스트했습니다.
custom_nodes폴더에서 노드를 불러오는 설치라면 데스크톱 앱, 포터블 빌드, 수동 설치 모두 됩니다. - API 키. 콘솔에서 만드세요. 키는
sk-spicy-로 시작합니다. 아직 계정이 없다면 계정 설정을 보세요. - 잔액. 실행 비용은 모두 미리 충전한 미국 달러 잔액에서 나갑니다. 과금을 보세요.
- ComfyUI를 실행하는 컴퓨터에서
api.spicyapi.ai에 접속할 수 있어야 합니다.HTTPS_PROXY로 지정한 프록시는 그대로 적용됩니다.
설치
노드 팩 설치하기
가장 빠른 방법은 ComfyUI Manager입니다. 상단 바의 Manager를 누르고 SpicyAPI를 검색한 뒤 Install을 누르세요. 기존(레거시) Manager 메뉴에서는 같은 검색이 Custom Nodes Manager 안에 있습니다.
레거시 메뉴에서 검색되지 않는다면, 노드 목록이 이 팩이 등록되기 전의 캐시로 남아 있는 것입니다. **DB: Channel (1day cache)**를 **DB: Channel (remote)**로 바꾸고 다시 검색하세요.
Manager를 쓰지 않는다면 직접 복제하세요.
cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapigit이 없나요? ZIP 파일을 받아 ComfyUI/custom_nodes에 풀면 됩니다. 설치할 Python 패키지는 없습니다.
ComfyUI 다시 시작하기
다시 시작하면 노드 메뉴에 SpicyAPI 그룹이 생기고, 그 안에 Image, Video, Audio, Text, Utils가 들어 있습니다. 나중에 업데이트하려면 Manager에서 이 팩의 Update를 누르거나, 직접 복제했다면 같은 폴더에서 git pull을 실행한 뒤 다시 시작하세요.
API 키 등록하기
Settings > SpicyAPI > API key를 열고 키를 붙여 넣으세요. 키가 정상이면 알림이 뜨면서 사용 가능한 잔액이 표시됩니다. 그런 다음 ComfyUI를 한 번 다시 시작하세요. 노드 목록은 ComfyUI가 시작될 때 내 계정의 실시간 카탈로그를 기준으로 만들어지며, 키를 등록하기 전에는 릴리스에 포함된 목록이 쓰입니다.
키는 ComfyUI 사용자 폴더의 파일(user/spicyapi/config.json)에 저장되고, 내 계정만 읽을 수 있습니다. 워크플로 파일이나 ComfyUI가 저장하는 이미지의 메타데이터에는 절대 기록되지 않으므로, 이 둘을 공유해도 키가 함께 공유되지 않습니다. 등록한 뒤에는 설정 입력란에 마지막 네 글자만 표시됩니다. 키를 지우려면 입력란을 비우세요.
서버나 컨테이너에서는 대신 SPICY_API_KEY 환경 변수를 설정하세요. 설정 입력란보다 우선합니다.
첫 노드 실행하기
모델 노드 추가하기
캔버스의 빈 곳을 더블클릭하고 z-image, seedance, kling, wan, suno, nano banana처럼 모델 이름의 일부를 입력하세요. 노드 이름은 spicyapi.ai의 모델 이름과 같습니다. 예를 들면 Seedance 2.5 · Image to Video입니다. 노드 메뉴의 SpicyAPI > Image / Video / Audio에서 개발사별로 묶인 목록을 훑어볼 수도 있습니다.
입력과 출력 연결하기
노드에 프롬프트를 쓰세요. 모델이 사진, 영상, 소리를 받는다면 Load Image, Load Video, Load Audio 노드를 해당 소켓에 연결하세요. 파일은 노드가 실행될 때 업로드됩니다. 노드의 출력에는 Save Image, Save Video, Save Audio를 연결하세요. ComfyUI는 출력 노드로 끝나는 그래프만 실행하기 때문입니다.
이미 동작하는 그래프에서 시작하고 싶다면 ComfyUI의 템플릿 브라우저에서 comfyui-spicyapi 아래의 예제를 고르세요. 텍스트→이미지, 이미지→영상, 채팅 모델이 이미지 모델용 프롬프트를 써 주는 그래프, 텍스트 음성 변환, LoRA가 있습니다.
실제 결과, 가격, 실행 시간이 담긴 작동 예제와 무검열 노드의 실시간 목록은 spicyapi.ai의 ComfyUI 페이지에서 볼 수 있습니다.
노드가 작동하는 방식
모든 노드는 해당 모델이 공개한 입력 스키마에서 생성됩니다. API가 요청을 검증할 때 쓰는 바로 그 스키마이므로, 노드가 모델이 거부할 옵션을 보여 주는 일은 없습니다.
| 모델이 받는 것 | 노드에서 보이는 것 |
|---|---|
| 해상도나 화면 비율처럼 정해진 값의 집합 | 드롭다운 |
| 길이나 강도처럼 범위가 있는 숫자 | 슬라이더 또는 숫자 입력란 |
| 켜고 끄는 설정 | 스위치 |
| 이미지, 영상, 오디오 파일 1개 | 입력 소켓 |
| 참조 파일 여러 개 | 연결할 때마다 늘어나는 소켓 그룹 |
| LoRA 파일 목록 | SpicyAPI LoRA 노드가 연결되는 loras 소켓 |
| 대본 형식의 대화처럼 구조가 있는 목록 | JSON을 받는 텍스트 입력란 |
드롭다운을 model default로 두거나 숫자를 -1로 두면 그 항목은 요청에서 빠지고, 모델이 자체 기본값을 씁니다.
출력은 평범한 ComfyUI 값이라서 다른 어떤 노드든 받을 수 있습니다.
- 이미지 모델은
IMAGE를 돌려줍니다. 배경 제거는alpha마스크도 함께 돌려줍니다. - 영상 모델은
VIDEO를 돌려주고,return_last_frame이 켜져 있으면 클립의 마지막 프레임을IMAGE로도 돌려줍니다. - 오디오 모델은
AUDIO를 돌려줍니다. Suno처럼 클립을 여러 개 돌려주는 모델은 하나의 배치로 돌려주며, Save Audio가 클립마다 파일을 하나씩 씁니다. - 음성 받아쓰기는
STRING을 돌려줍니다. - 모든 노드는 콘솔 로그나 지원 문의에 쓸 수 있도록
task_id도 돌려줍니다.
Chat 노드와 LoRA 노드
SpicyAPI Chat은 프롬프트와 선택 사항인 시스템 지시문, 선택 사항인 이미지를 SpicyAPI의 어떤 텍스트 모델에든 보내고, 답변을 STRING으로 돌려줍니다. 이미지나 영상 노드의 prompt에 연결하면 그래프 안에서 언어 모델이 프롬프트를 쓰거나 다듬게 할 수 있습니다. 이미지를 읽지 못하는 모델에 이미지를 넣으면 거부되며 비용은 청구되지 않습니다.
SpicyAPI LoRA는 LoRA 가중치 파일 하나를 추가합니다. .safetensors 파일의 직접 다운로드 링크를 입력하고, 강도는 0에서 4 사이로 정합니다. 여러 개를 이어 붙이면 겹쳐서 적용되며, 마지막 노드를 LoRA 모델 노드(이름이 LoRA로 끝납니다)의 loras 입력에 연결하세요. 링크는 로그인 없이 열려야 합니다.
실행 비용
- 각 노드의 배지는 선택한 옵션에 대한 모델의 현재 요금을 보여 줍니다. 예를 들어 영상은
$0.0525/s, 이미지는$0.01/image처럼 표시되고, 옵션을 바꾸면 함께 바뀝니다. - 모든 실행은 먼저 견적을 받습니다. Settings > SpicyAPI > Max cost per run에서 미국 달러 기준 상한을 정하세요. 견적이 그 금액을 넘는 실행은 과금되기 전에 멈춥니다.
- 최종 청구액은 실행이 끝나면 노드에 표시됩니다. 실패한 실행은 청구되지 않습니다. 다만 모델 페이지에 거부도 과금된다고 적힌 모델은 예외입니다. 과금을 보세요.
- 시드는
fixed로 시작합니다. 같은 그래프를 두 번 실행하면 다시 결제하지 않고 첫 결과를 재사용합니다. 실행할 때마다 새 결과를 받고 새로 과금되게 하려면 control after generate를randomize로 바꾸세요. - 취소는 기다림을 멈출 뿐, 작업을 멈추지는 않습니다. ComfyUI에서 취소한 실행도 SpicyAPI에서는 계속 진행되어 성공하면 청구되고, 결과는 콘솔 로그에서 볼 수 있습니다.
결과는 콘솔에 최대 14일 동안 남으며, 계정에서 더 짧게 보관하도록 설정했다면 그 기간만큼만 남습니다. 내 사본을 남기려면 ComfyUI의 Save 노드를 쓰세요. 보관 기간을 보세요.
문제 해결
| 보이는 증상 | 할 일 |
|---|---|
No SpicyAPI key is set | Settings > SpicyAPI에 키를 등록하거나 SPICY_API_KEY를 설정한 뒤 다시 실행하세요. |
SpicyAPI rejected this key | 콘솔에서 키를 다시 복사하세요. 폐기된 키는 즉시 작동을 멈춥니다. |
| 웹사이트에 있는 모델이 목록에 없음 | ComfyUI를 다시 시작하세요. 새 모델은 출시 후 첫 재시작부터 나타납니다. |
40310 | 계정의 이메일 주소가 인증되지 않았습니다. 가입 때 받은 메일의 링크를 여세요. |
40004 | 그 옵션 조합을 처리하는 배포가 없습니다. 메시지에 적힌 옵션을 바꾸세요. |
This run could cost up to … | 견적이 Max cost per run을 넘었습니다. 한도를 올리거나 더 저렴한 옵션을 고르세요. 청구된 금액은 없습니다. |
a proxy or firewall … may be intercepting the request | 이 컴퓨터에서 api.spicyapi.ai에 제대로 접속하지 못합니다. HTTPS_PROXY와 방화벽 규칙을 확인하세요. |
SpicyAPI가 돌려주는 오류 끝에는 request_id나 작업 ID가 붙습니다. 지원팀에 문의할 때 그 값을 알려 주면 해당 요청을 정확히 찾을 수 있습니다. 오류 코드는 오류에서 설명합니다.