RunningHub란: 그래픽카드 없이 쓰는 클라우드 워크플로 플랫폼
고화질 인물 컷이나 모션 비디오를 생성하는 숏폼 드라마 제작 환경에서는 대용량 그래픽카드 메모리가 필수적입니다. 하지만 개인 PC에 고사양 GPU를 마련하고 파이썬 환경이나 대용량 모델 파일을 일일이 관리하는 일은 창작자에게 큰 기술적 부담이 됩니다.
RunningHub는 ComfyUI 기반의 노드 파이프라인과 패키징된 AI 웹앱을 원격 클라우드 GPU에서 실행해 주는 플랫폼입니다. 로컬 컴퓨터의 사양과 상관없이 웹 브라우저나 API 연동만으로 복잡한 생성 작업을 클라우드 서버에 맡기고 결과물을 받아볼 수 있습니다.
- 로컬 PC의 VRAM 용량 한계 없이 클라우드 고성능 GPU 연산 자원을 활용합니다.
- 대용량 체크포인트 모델이나 노드 충돌을 직접 해결할 필요가 없습니다.
- 사용 지역 환경에 맞춰 중국 서버(runninghub.cn)와 글로벌 서버(runninghub.ai)를 선택해 접속할 수 있습니다.
워크플로와 AI 웹앱(webapp)의 차이 및 각각의 ID 찾는 법
RunningHub 사용법을 익힐 때 가장 먼저 마주치는 개념이 워크플로(Workflow)와 AI 웹앱(Webapp)의 구분입니다. 두 방식은 다루는 인터페이스의 깊이와 식별 번호가 다르므로 본인의 작업 목적에 맞게 골라야 합니다.
워크플로는 ComfyUI 본래의 노드 그래프 전체를 다루는 방식입니다. 프롬프트, 샘플러, 스텝 수, CFG 값 등 세부 노드 매개변수를 직접 수정하며 정교한 드라마 컷을 연출할 때 적합합니다. 반면 AI 웹앱은 특정 작업에 필요한 입력값(인물 사진, 지시문, 스타일 선택 등)만 겉으로 노출하고 내부 그래프를 단순화해 둔 간이 도구입니다. 외부 도구와 연동하려면 각 프로젝트의 고유 식별 ID가 필요합니다.
워크플로 ID(workflowId) 확인
RunningHub 공식 설명에 따르면 워크플로를 열고 웹 브라우저 주소창에서 workflowId를 확인할 수 있습니다. 아울러 공식 권장 사항으로, 먼저 RunningHub 웹페이지에서 해당 워크플로를 수동으로 한 번 정상 실행해 본 뒤 API로 호출해야 오류를 방지할 수 있습니다.
AI 웹앱 ID(webappId) 확인
해당 AI 앱 페이지를 열어 확인할 수 있으며, 보통 페이지 웹 주소(URL)에서 확인할 수 있습니다.
RunningHub API 키 발급: 포인트 API 키와 기업용 소재 키의 역할
RunningHub API 연동을 진행할 때는 계정 대시보드에서 발급받는 두 가지 API 키의 성격을 구분해야 합니다. 하나의 키로 모든 작업이 처리될 것으로 오해하면 이미지 업로드나 작업 생성 도중 권한 오류를 겪게 됩니다.
첫 번째는 포인트 API 키(Credits API Key)입니다. 이 키는 워크플로 파라미터 구조를 조회하고, 새로운 생성 작업을 큐에 제출하며, 작업 상태와 결과물을 받아오는 핵심 호출 전반에 사용됩니다. 이 키로 작업이 제출될 때 계정의 포인트가 차감됩니다.
두 번째는 기업용 소재 업로드 키(Enterprise Material Upload Key)입니다. 드라마 제작 시 이전 컷의 인물 얼굴을 유지하기 위한 캐릭터 참조 사진, 가이드 포즈 비디오, 오디오 클립, 마스크 이미지처럼 외부 미디어 파일을 클라우드로 전송할 때만 전용으로 동작하는 업로드 인증 키입니다.
- 포인트 API 키: 작업 요청 생성, 파라미터 조회, 결과물 수신 등 메인 파이프라인에 필수적입니다.
- 기업용 소재 업로드 키: 참조 이미지, 참조 비디오, 참조 오디오, 마스크 파일을 클라우드 서버에 올릴 때만 사용합니다.
- 두 키는 RunningHub 계정의 API 관리 메뉴에서 각각 별도로 발급받으므로 섞이지 않도록 입력란을 나누어 확인해야 합니다.
자주 발생하는 오류와 실패 원인 점검
API 연동 중 작업이 멈추거나 실패한다면 모델 자체의 오류보다는 설정 누락이나 키 오입력 때문일 가능성이 큽니다. 에러가 발생했을 때는 다음 점검 사항을 차례대로 확인합니다.
잔여 포인트 부족 및 키 오입력 확인
포인트가 부족하면 요청이 실패하므로 충전 후 다시 시도해야 합니다. 작업 생성 요청이 거절된다면 포인트 API 키 자리에 소재 업로드 키를 잘못 넣었는지 확인하고, RunningHub 계정의 잔여 포인트 상태를 대시보드에서 점검합니다.
워크플로 ID 변경 후 파라미터 미동기화
새로운 워크플로 ID를 입력했거나 노드 구조를 수정한 뒤 파라미터 불러오기를 누르지 않으면, 시스템이 이전 입력 규격을 기준으로 데이터를 전송하여 요청 오류가 발생합니다.
참조 미디어 필드 매핑 지정 누락
참조 이미지, 참조 비디오, 참조 오디오, 마스크를 전달하도록 설정했더라도, 해당 데이터가 워크플로 내부의 어느 노드 입력 포트로 연결되는지 필드 매핑을 지정해두지 않으면 값이 빈 상태로 전달되어 생성이 실패합니다.
DramaCanvas에 RunningHub 연동하기: 플러그인 활성화 및 키 설정
DramaCanvas에서는 별도의 파이썬 코드나 터미널 조작 없이, 기본 내장된 RunningHub 플러그인을 활성화하여 캔버스 위에서 워크플로를 호출할 수 있습니다. 등록된 인증 키는 플랫폼 보안 환경 내에 안전하게 저장되며 플러그인 자체가 키를 외부로 노출하지 않습니다.
설정을 저장해 두면 여러 개의 이미지 컷 생성 워크플로나 모션 비디오용 웹앱을 목록으로 관리하며 캔버스 작업 도중 선택해 사용할 수 있습니다.
플러그인 센터에서 기능 활성화
DramaCanvas의 플러그인 센터로 이동하여 RunningHub 워크플로 플러그인을 활성화합니다. 계정 등급과 무관하게 누구나 켤 수 있습니다.
서버 위치 선택 및 API 키 입력
설정 페이지의 RunningHub 메뉴에서 중국 사이트(runninghub.cn) 또는 글로벌 사이트(runninghub.ai)를 지정하고, 발급받은 포인트 API 키와 기업용 소재 업로드 키를 입력합니다.
ID 입력 및 파라미터 가져오기
사용 용도(이미지, 비디오, 오디오 중 선택)를 지정한 뒤 준비한 workflowId 또는 webappId를 입력하고 '파라미터 가져오기'를 누릅니다.
필드 매핑 편집과 테스트 실행
불러온 입력 필드 목록에서 매개변수 설정과 참조 미디어 필드가 올바르게 매핑되었는지 확인하고, 테스트 요청을 실행해 정상 작동을 확인한 뒤 항목을 저장합니다.
캔버스에서 워크플로 노드로 드라마 컷 생성하기
설정을 마친 워크플로는 스토리보드 캔버스 위에서 다른 장면 카드들과 유기적으로 상호작용하는 워크플로 노드로 동작합니다.
캔버스에서 노드 추가 메뉴를 눌렀을 때 워크플로 항목이 보이지 않는다면, 캔버스 최상단 도구 모음에서 작업 모드를 확인해야 합니다. 기본 '간단 모드'에서는 간소화된 도구만 표시되므로, 이를 '전문가 모드'로 전환하면 노드 추가 메뉴에 '워크플로'가 나타납니다.
워크플로 노드의 매개변수 필드는 저장된 워크플로 설정에서 불러옵니다. 시드는 주사위 아이콘을 클릭하여 무작위로 변경할 수 있습니다.
노드에 연결된 참조 이미지, 참조 비디오, 참조 오디오, 마스크만 필드 설정에 따라 워크플로 입력에 자동으로 채워집니다(업로드가 필요할 때는 기업용 소재 업로드 키를 사용합니다). 텍스트 카드나 프롬프트는 워크플로 입력으로 연결할 수 없습니다.
이용 요금 및 비용 안내: 플랫폼 간 분리 과금 원칙
DramaCanvas에서 RunningHub 또는 ComfyUI Bridge를 통해 워크플로를 실행할 때 DramaCanvas 포인트는 차감되지 않습니다. 시스템 내부 렌더링 채널을 거치지 않으므로 DramaCanvas 상의 과금도 발생하지 않습니다.
RunningHub 이용 비용은 RunningHub 자체 규칙에 따라 사용자 본인의 RunningHub 계정에서 부과됩니다.
포인트가 부족하면 요청이 실패하므로 충전 후 다시 시도해야 합니다. 작업을 진행하기 전에는 RunningHub 웹 대시보드에 접속해 잔여 포인트가 충분한지 미리 확인하는 것이 안전합니다.
- DramaCanvas: RunningHub 또는 ComfyUI Bridge를 통한 워크플로 실행 시 DramaCanvas 포인트 차감 없음
- RunningHub: RunningHub 자체 규칙에 따라 비용 부과
- 포인트 부족 시 요청이 실패하므로 충전 후 다시 시도해야 합니다.
자주 묻는 질문
RunningHub를 사용하려면 고사양 PC나 그래픽카드가 필요한가요?
필요하지 않습니다. 모든 ComfyUI 연산과 모델 구동은 RunningHub의 원격 클라우드 GPU에서 처리되므로, 일반 휴대용 노트북이나 사무용 컴퓨터의 웹 브라우저에서도 문제없이 장면을 생성하고 결과를 확인할 수 있습니다.
포인트 API 키만 있고 소재 업로드 키가 없어도 실행할 수 있나요?
텍스트 프롬프트 매개변수만 사용하는 기본 워크플로라면 포인트 API 키만으로도 실행할 수 있습니다. 다만 노드에 연결된 참조 이미지, 참조 비디오, 참조 오디오, 마스크를 워크플로 입력에 자동으로 채워 넣고 업로드하려면 기업용 소재 업로드 키가 반드시 필요합니다.
캔버스 노드 추가 메뉴에 '워크플로'가 보이지 않는 이유는 무엇인가요?
캔버스 작업 모드가 '간단 모드'로 설정되어 있을 가능성이 높습니다. 캔버스 상단 메뉴 바에서 작업 모드를 '전문가 모드'로 전환하면 노드 추가 메뉴에 '워크플로' 항목이 정상적으로 나타납니다.
DramaCanvas에서 워크플로를 실행하면 서비스 포인트가 차감되나요?
차감되지 않습니다. DramaCanvas에서 RunningHub 또는 ComfyUI Bridge를 통해 워크플로를 실행할 때 DramaCanvas 포인트는 차감되지 않습니다. RunningHub 이용 비용은 RunningHub 자체 규칙에 따라 사용자 본인의 RunningHub 계정에서 부과됩니다.
연속된 드라마 컷에서 주인공의 얼굴과 스타일을 동일하게 유지할 수 있나요?
생성형 AI 특성상 완전한 일치를 보장할 수는 없지만, 노드에 캐릭터 원본 참조 이미지를 연결하고 프롬프트를 유지하면 인물 특성을 일관되게 유지하기가 수월해집니다. 결과가 만족스럽지 않다면 시드를 변경하거나 다른 구도의 참조 사진을 연결하여 다시 시도하는 방식을 권장합니다.
ComfyUI 워크플로 연동과 AI 웹앱(webapp) 연동 중 어떤 것을 써야 하나요?
샘플러, 스텝 수, CFG 값 등 세부적인 매개변수를 직접 조율하며 정교한 드라마 컷을 만들고 싶다면 워크플로 연동이 적합합니다. 반면 복잡한 설정 없이 인물 사진과 간단한 지시문만 넣어 규격화된 컷을 생성하고 싶다면 간소화된 AI 웹앱을 연결하는 편이 편리합니다.