ComfyUI에 중계 API를 연동하여 GPTImage2 등 임의 모델 호출하기

모델을 바꿀 때마다 도구 체인을 새로 구축하는 것에 지치셨나요? 이제 ComfyUI-relayapi라는 오픈소스 프로젝트를 통해 ComfyUI에 임의 중계站 API를 연동하고, GPT Image 2, Gemini, Veo 등 주류 AI 모델을 간편하게 호출하여 이미지, 영상, 음악을 올인원으로 생성할 수 있습니다.

커스텀 노드로 ComfyUI에서 임의 API 호출하기

ComfyUI-relayapi는 가볍고 즉시 사용 가능한 커스텀 노드 패키지입니다. 통합 구성 인터페이스를 통해 사용자가 ComfyUI 워크플로우에서各类第三方 중계站 API를 편리하게 호출할 수 있도록 지원합니다. 텍스트 생성, 이미지 창작, 영상 제작, 음악 합성을 막론하고 하나의 노드로 해결할 수 있습니다.

https://github.com/flywhale-666/ComfyUI-relayapi.git

핵심 기능

이 프로젝트는 5개의 핵심 노드를 제공하며 분류가 명확합니다:

• Relay API Settings: 작업 유형, 플랫폼, API 형식, 중계站 주소, 모델 및 키를 통합 구성

• Relay Text Generator: 텍스트 생성, 다중 턴 대화 및 다중 이미지 비전 이해

• Relay Image Generator: 텍스트-투-이미지, 이미지 편집/레퍼런스 이미지 퓨전

• Relay Video Generator: 영상 생성(Grok/Veo 지원, 내장 비동기 작업 생성 및 상태 조회)

• Relay Sound Generator: AI 음악 생성(Suno 인터페이스 심층 대응)

설치 방법

1. 프로젝트를 클론하거나 다운로드하여 ComfyUI의 커스텀 노드 디렉토리에 배치합니다: ComfyUI/custom_nodes/ComfyUI-relayapi/

2. ComfyUI를 재시작합니다

3. 노드 검색창에 RelayAPI를 입력하면 모든 관련 노드를 확인할 수 있습니다

지원 모델 유형

현재 지원되는 작업 유형과 내장 모델:

• 텍스트 생성: gemini-3.1-flash-lite-preview, claude-opus-4-6 등(openai_style/gemini_style 형식 지원)

• 이미지 생성: gpt-image-2, nano-banana-pro, gemini-3-pro-image-preview 등

• 영상 생성: grok-video-3, veo3.1, veo3.1-fast(V1/V2 인터페이스 지원)

• 음악 생성: Suno V3~V5.5 완전 매핑(chirp-v3.0부터 chirp-fenix 시리즈까지)

구성 및 사용 튜토리얼

1단계: Settings 노드 추가

캔버스에 Relay API Settings 노드를 추가합니다. 이 노드는 모든 생성의 상위 구성 센터입니다. 다음을 설정해야 합니다:

• task_type(작업 유형): text/image/video/sound

• platform(플랫폼): gemini_style, openai_style 또는 relay_api_style 등

• model(모델명): 예: gpt-image-2

• apikey(API 키): 중계站 키 입력

• custom_api_base(선택): 커스텀 중계站 주소

2단계: 생성 노드 연결

Settings 노드의 info 출력선을 해당 생성 노드(예: Relay Image Generator)에 연결합니다. 그런 다음 입력 매개변수를 구성합니다:

• Prompt(프롬프트)

• 비율/해상도

• 레퍼런스 이미지(이미지 편집 시 선택 가능)

3단계: 실행 및 출력

'Queue Prompt'를 클릭하면 생성이 시작됩니다. 모든 노드는 response(간결한 JSON)를 반환하며, 상태 코드, 소요 시간, 사용량 등의 정보를 포함하여 디버깅에 편리합니다.

추천 중계站 플랫폼

다음은 성능이 안정적이고 가격이 투명한, ComfyUI-relayapi 연동을 지원하는 중계站입니다:

• 구구(QiuQiu) Token 플랫폼: 무료 가입 - GPT Image 2, Opus, Gemini 등 주류 모델 제공, 낮은 지연, 높은 동시 처리량

• luchikey API: 무료 가입 - 다양한 모델 호출 지원, 합리적인 가격

• 총밍(CongMing) AI: 무료 가입 - 경제적인 GPT

• !!중요 안내: API 중계站은 모두 잠적 위험이 있습니다! 소액으로 체험하고, 적은 금액을 여러 번 결제하며, 절대로 대금 상업용으로 사용하지 마세요.

주의사항 및 최적화 제안

1. API Key 매칭: Key는 api_base와 엄격히 일치해야 하며, 혼용 시 빈 응답 오류가 발생합니다

2. 비동기 작업 처리: 영상 및 음악 생성은 '제출-폴링' 메커니즘을 채택하며, 노드가 생성부터 조회까지의 전체 프로세스를 자동 처리합니다

3. 해상도 제한: 일부 중계站/모델 채널은 고해상도 매개변수를 무시할 수 있습니다(예: 1080P 요청 시 실제로 720P 반환). 이는 서버 측 제한에 해당합니다

4. 안전 필터: 콘텐츠 심사가 트리거되면 PUBLIC_ERROR_UNSAFE_GENERATION이 반환됩니다

5. UI 멈춤 방지 최적화: 영상 응답의 Base64 이미지는 길이 안내로 잘라내어 UI 멈춤을 방지합니다

자주 묻는 질문

Q: 새 중계站 주소를 어떻게 추가하나요?
A: Settings 노드의 custom_api_base 필드에 새 주소를 직접 입력하면 됩니다. delete:주소를 입력하면 기존 주소를 삭제할 수 있습니다.

Q: 구성 파일은 어디에 있나요?
A: 구성은 프로젝트 루트 디렉토리의 relay_config.json에 자동 저장됩니다. 실제 API Key가 포함된 구성 파일을 공개 저장소에 절대 커밋하지 마세요.

Q: 어떤 영상 생성 모델을 지원하나요?
A: 현재 내장 모델은 grok-video-3, veo3.1, veo3.1-fast이며, V1/V2 인터페이스를 통해 호출합니다.

이미지 디자이너, 영상 크리에이터, 음악 프로듀서 모두 이 오픈소스 프로젝트를 통해 주류 AI 모델에 빠르게 접근하고, 번거로운 도구 전환에서 벗어날 수 있습니다. 안정적인 중계站 서비스와 결합하면, 창의력이 더 이상 단일 플랫폼에 제한되지 않을 것입니다.