MonstarX에서 HeyGen 사용하기

Q: MonstarX가 알아서 영상을 만들 수 있나요?

아니요. 만들기 모드에서, 영상을 명시적으로 요청한 경우에만 만듭니다. 계획 모드와 대화 모드에서는 둘러볼 수만 있고 만들 수는 없습니다.

핵심 요약백엔드 → 클라우드의 HeyGen 행에 HeyGen API 키를 붙여 넣으세요. 그러면 MonstarX 에이전트가 모든 모드에서 아바타, 음성, 영상을 둘러보고, 만들기 모드에서 요청하면 스크립트를 말하는 아바타 영상을 만듭니다. 영상을 만들면 HeyGen 크레딧이 쓰입니다.

아바타와 음성을 둘러보고 아바타 영상을 만듭니다.

유형: 업무 도구 · API 키
카테고리: AI와 미디어
연결 방법: API 키

HeyGen은 실제 사람 같은 발표자, 즉 아바타가 선택한 목소리로 스크립트를 읽는 영상을 만듭니다. API 키(소프트웨어가 내 계정을 쓸 수 있게 해 주는, 비밀번호 같은 코드)로 HeyGen 계정을 연결하면 MonstarX 에이전트(대화를 나누는 AI)가 아바타, 음성, 영상을 살펴보고, 홈페이지 환영 인사처럼 앱에 쓸 새 아바타 영상을 만들 수 있습니다.

이 커넥터는 업무 도구입니다. MonstarX가 작업 중에 사용자를 대신해 HeyGen을 사용합니다. 만드는 앱에는 키가 전달되지 않습니다.

MonstarX는 무엇을 할 수 있나요?

MonstarX가 할 수 있는 일	언제
결제 유형과 잔액을 포함해 계정 확인	모든 모드
아바타 룩과 음성 둘러보기: 한 번에 룩은 최대 50개, 음성은 최대 100개	모든 모드
영상 목록 보기와 영상 하나의 상태·세부 정보 확인	모든 모드
아바타 영상 만들기: 아바타 룩 하나, 음성 하나, 최대 10,000자의 스크립트로 1080p 영상을 만들며 제목은 선택 사항입니다.	만들기 모드에서, 영상을 명시적으로 요청한 경우에만

다음 작업은 하지 않습니다: 영상, 아바타, 음성 편집이나 삭제, 새 아바타 만들기, HeyGen 계정 변경.

시작하기 전에

API 접근이 가능하고, 원하는 영상을 만들 만큼 크레딧이나 잔액이 있는 HeyGen 계정이 필요합니다. HeyGen의 API 사용량 페이지를 확인하세요.
MonstarX 프로젝트의 소유자여야 합니다. 도구를 연결하거나 연결 해제할 수 있는 사람은 소유자뿐입니다.

키 발급받기

HeyGen에 로그인하고 개발자용 API 페이지를 여세요.
API 키를 만들고 복사하세요. HeyGen은 키를 한 번만 보여 줍니다.
권한 범위(scope)로 키를 제한한다면 최소한 account:read(연결할 때 MonstarX가 확인합니다)와 avatars:read, voices:read, videos:read를 주세요. videos:write는 MonstarX가 영상을 만들어야 할 때만 추가하세요. 모든 권한이 있는 키도 쓸 수 있습니다.

HeyGen 공식 가이드: API key

MonstarX에서 연결하기

프로젝트를 열고 상단 바에서 백엔드를 클릭한 다음 클라우드를 클릭하세요.
커넥터까지 스크롤해 HeyGen을 찾고 연결을 클릭하세요.
API 키 입력란에 키를 붙여 넣고 연결을 클릭하세요.
MonstarX가 계정 정보를 읽어 키를 확인합니다. 확인되면 행에 연결됨이 표시됩니다. HeyGen이 키를 거부하면 오류 메시지가 표시되고, 아무것도 저장되지 않습니다.

MonstarX에 사용 요청하기

입력 예시	결과
“내 HeyGen 계정에 있는 여성 아바타 룩과 따뜻한 느낌의 한국어 음성을 보여 주세요.”	MonstarX가 조건에 맞는 아바타 룩과 음성을 ID와 함께 목록으로 보여 줍니다.
“그 아바타와 음성으로 이 스크립트를 읽는 30초짜리 HeyGen 환영 영상을 만들어 주세요: …”	만들기 모드에서 HeyGen에 영상을 만들어 달라고 요청합니다. HeyGen이 영상을 렌더링하는 데 시간이 걸립니다.
“환영 영상 다 됐나요?”	HeyGen에서 영상 상태를 확인해 알려 주고, 완성되었다면 영상의 세부 정보도 알려 줍니다.

보안과 개인정보 보호

MonstarX에만 보관됩니다. 키는 암호화되어 MonstarX 서버에 저장됩니다. 앱 코드에 기록되거나 앱에 전달되는 일은 없습니다.
프로젝트 하나에서만 작동합니다. 키는 연결한 프로젝트에서만 쓸 수 있습니다.
정보로만 읽습니다. MonstarX는 HeyGen에서 읽은 내용을 작업에 참고할 정보로만 다루며, 지시로 따르지 않습니다.
언제든 연결 해제할 수 있습니다. 백엔드클라우드에서 HeyGen 옆의 연결 해제를 클릭하고 이 프로젝트에서 HeyGen 연결을 해제할까요?를 확인하세요. MonstarX는 키를 삭제합니다. 키가 어디에서도 작동하지 않게 하려면 HeyGen에서 키를 삭제하세요.

알아 두면 좋은 점

영상은 1080p 해상도에 HeyGen의 자동 화면 비율로 만들어집니다. 렌더링은 HeyGen에서 이루어지며 몇 분 걸릴 수 있습니다.
MonstarX는 HeyGen에 이미 있는 아바타 룩을 씁니다. 새 아바타는 HeyGen에서 직접 만드세요.
영상은 HeyGen에서 직접 만든 영상과 함께 내 HeyGen 계정에 보관됩니다.

자주 묻는 질문

MonstarX가 알아서 영상을 만들 수 있나요?

아니요. 만들기 모드에서, 영상을 명시적으로 요청한 경우에만 만듭니다. 계획 모드와 대화 모드에서는 둘러볼 수만 있고 만들 수는 없습니다.

아바타를 둘러보면 크레딧이 쓰이나요?

아니요. 아바타, 음성, 영상 목록을 보거나 영상 상태를 확인하는 것은 아무것도 만들지 않습니다. HeyGen 크레딧은 영상을 만들 때만 쓰입니다.

앱 사용자를 위해 HeyGen 영상을 만들게 할 수 있나요?

이 연결로는 안 됩니다. 이 키는 MonstarX 에이전트 전용입니다. 앱이 직접 HeyGen을 호출하는 기능을 원한다면 백엔드 → 시크릿에 HeyGen 키를 추가하고 MonstarX에 기능을 만들어 달라고 요청하세요. 시크릿으로 API 키 안전하게 보관하기를 참고하세요.