HeyGen 자동화
Composio MCP 통합을 통해 AI 기반 비디오 제작 워크플로우를 자동화하세요. 아바타와 템플릿을 탐색하고, 템플릿에서 맞춤형 비디오를 생성하며, 처리 상태를 추적하고, 공유 가능한 URL을 검색할 수 있습니다.
툴킷 문서: composio.dev/toolkits/heygen
설정
https://rube.app/mcp에서 Composio MCP 서버를 통해 HeyGen 계정을 연결하세요.- 활성 연결이 없으면 에이전트가 인증 링크를 제공합니다.
- 연결이 완료되면 모든
HEYGEN_*도구를 실행할 수 있습니다.
핵심 워크플로우
1. 사용 가능한 템플릿 탐색
HeyGen 라이브러리에서 미리 디자인된 아바타 템플릿을 검색하여 비디오 제작에 활용합니다.
도구: HEYGEN_V2_TEMPLATES
매개변수 불필요 -- 템플릿 ID, 이름, 미리보기 이미지 및 사용자 정의 옵션을 반환합니다.
비디오를 생성하기 전에 템플릿을 발견하는 데 사용합니다. 각 템플릿은 생성에 필요한 고유 ID를 가지고 있습니다.
2. 템플릿 세부 정보 및 변수 검사
모든 변수, 장면 매핑 및 사용자 정의 옵션을 포함한 템플릿의 전체 구조를 검색합니다.
도구: HEYGEN_RETRIEVE_TEMPLATE_DETAILS_V3
| 매개변수 | 타입 | 필수 | 설명 |
|---|---|---|---|
template_id | string | 예 | HEYGEN_V2_TEMPLATES 또는 HeyGen 대시보드에서 가져온 템플릿 ID |
비디오를 생성하기 전에 반드시 수행해야 하는 필수 사전 단계입니다. 어떤 변수를 채워야 하는지 정확히 알려줍니다.
3. 사용 가능한 아바타 탐색
비디오 제작에 사용 가능한 모든 사실적인 아바타를 나열하며, 캐릭터를 장면에 매핑하는 데 유용합니다.
도구: HEYGEN_V2_AVATARS
매개변수 불필요 -- 아바타 식별자, 이름 및 미리보기 이미지를 반환합니다.
목록이 페이지로 나뉠 수 있으므로 전체 집합을 얻기 위해 추가 호출이 필요할 수 있습니다.
4. 템플릿에서 비디오 생성
변수와 콘텐츠로 템플릿을 채워 맞춤형 비디오를 만듭니다.
도구: HEYGEN_V2_TEMPLATE_GENERATE
비디오 제목과 HEYGEN_RETRIEVE_TEMPLATE_DETAILS_V3에서 찾은 모든 템플릿 변수를 제공하세요. 모든 필수 변수는 정확한 이름과 타입으로 제공되어야 합니다.
5. 비디오 처리 상태 확인
생성 중인 비디오의 처리 상태를 폴링하고 메타데이터를 검색합니다.
도구: HEYGEN_RETRIEVE_VIDEO_STATUS_DETAILS
| 매개변수 | 타입 | 필수 | 설명 |
|---|---|---|---|
video_id | string | 예 | 생성 API에서 반환된 비디오 ID |
반환된 URL은 7일 후 만료되지만, 이 엔드포인트를 다시 호출하여 재생성할 수 있습니다.
6. 공유 가능한 비디오 URL 가져오기
인증 없이 누구나 비디오를 볼 수 있는 공개 공유 링크를 생성합니다.
도구: HEYGEN_RETRIEVE_SHARABLE_VIDEO_URL
video_id를 제공하면 배포용 공개 URL이 반환됩니다.
알려진 문제점
| 문제점 | 세부 사항 |
|---|---|
| 모든 템플릿 변수 필요 | HEYGEN_V2_TEMPLATE_GENERATE는 HEYGEN_RETRIEVE_TEMPLATE_DETAILS_V3의 모든 변수를 정확한 이름과 타입으로 요구합니다. 누락되거나 이름이 잘못된 필드는 장면을 깨뜨리거나 생성을 실패하게 합니다. |
| 항상 템플릿을 먼저 검사할 것 | 생성 전에 HEYGEN_RETRIEVE_TEMPLATE_DETAILS_V3를 절대 건너뛰지 마세요. 다중 장면 템플릿은 복잡한 변수 구조를 가지고 있습니다. |
| 비디오 URL 만료 | HEYGEN_RETRIEVE_VIDEO_STATUS_DETAILS의 URL은 7일 후 만료됩니다. 엔드포인트를 다시 호출하여 재생성하세요. |
| 페이지가 나뉜 아바타 목록 | HEYGEN_V2_AVATARS는 페이지로 나뉜 결과를 반환할 수 있습니다. 전체 라이브러리를 위해 추가 호출이 필요할 수 있습니다. |
| 처리 시간 가변 | 비디오 생성은 비동기식입니다. 출력 URL을 사용하기 전에 HEYGEN_RETRIEVE_VIDEO_STATUS_DETAILS를 폴링하여 상태가 완료될 때까지 기다리세요. |
빠른 참조
| 도구 슬러그 | 목적 |
|---|---|
HEYGEN_V2_TEMPLATES | 사용 가능한 비디오 템플릿 나열 |
HEYGEN_RETRIEVE_TEMPLATE_DETAILS_V3 | 템플릿 변수 및 장면 구조 가져오기 |
HEYGEN_V2_AVATARS | 사용 가능한 AI 아바타 탐색 |
HEYGEN_V2_TEMPLATE_GENERATE | 템플릿에서 비디오 생성 |
HEYGEN_RETRIEVE_VIDEO_STATUS_DETAILS | 비디오 처리 상태 확인 및 URL 가져오기 |
HEYGEN_RETRIEVE_SHARABLE_VIDEO_URL | 공개 공유 비디오 링크 가져오기 |
Composio 제공