AI 아바타와 Claude Skills 숏폼 자동화: 제작 규칙부터 영상 검수까지

Claude Skills로 숏폼을 자동화할 때는 역할을 둘로 나눠 생각하면 쉽습니다. Skills에는 대본 형식과 검수 규칙을 담고, 실제 영상은 연결된 HeyGen 같은 외부 도구가 만드는 구조예요. Skills는 지침·스크립트·참고 자료를 묶어 재사용하는 단위라서 설치만 해서는 영상이 나오지 않습니다. 영상 도구의 연결과 인증도 함께 준비해야 해요.

HeyGen을 예로 들면 자동화 범위는 '대본 확정 → 영상 생성 요청 → 완료 확인·파일 저장 → 검수'까지로 잡을 수 있습니다. 여기서 가장 자주 헷갈리는 지점은 요청 접수를 완성으로 착각하는 경우예요. 요청이 접수된 뒤에도 영상 처리가 남아 있으니, 생성 요청이 성공한 것과 완성본을 손에 넣은 것은 따로 확인해야 합니다.

HeyGen은 어디서 호출할까: 실행 환경과 인증

아바타 외형을 고르는 일은 나중에 해도 됩니다. 그보다 먼저 외부 서비스를 어디서 호출할지를 정하세요. Claude의 Agent Skills 문서에 따르면 Claude API의 Skills 실행 컨테이너에는 네트워크 접근이 없고, Claude Code는 사용자 컴퓨터의 네트워크 환경을 따릅니다. 그러니 API 기반 서비스를 만든다면 HeyGen 호출을 맡을 애플리케이션을 따로 설계해야 해요.

HeyGen 공식 Skills는 MCP 또는 CLI를 사용합니다. MCP는 에이전트가 외부 도구를 호출할 수 있게 연결해 주는 인터페이스예요. HEYGEN_API_KEY가 설정되어 있으면 CLI의 API 사용량 과금이 우선 적용되고, API 키 없이 MCP OAuth로 연결하면 기존 HeyGen 플랜의 크레딧을 씁니다. Claude 구독료와 영상 생성 비용을 같은 돈으로 착각하기 쉬운데, 둘은 별개로 보시는 게 맞습니다. 다만 이 선택 규칙은 HeyGen 공식 Skills에 해당하는 내용이라, 직접 구현한다면 실제 인증과 결제 경로를 따로 확인해야 합니다.

대본과 아바타 정보는 한 번 정해 두고 재사용하기

기술 설명 숏폼이라면 확정 대본을 넘기는 방식부터 구현하길 권합니다. 유료 생성을 요청하기 전에 용어와 사실관계를 검토할 수 있어서예요. HeyGen MCP의 create_video는 전달한 대본이나 오디오에 맞춰 아바타 영상을 만들고, create_video_agent는 대본과 장면 구성까지 포함하는 더 넓은 작업을 맡습니다. 처음부터 넓은 쪽으로 가기보다 대본 확정 시점을 분명히 두는 편이 검수 기준을 세우기에 수월합니다.

Skills에는 대본 형식, 표현 규칙, 기술 용어 표기, 검수 절차를 담아 두세요. 아바타·음성의 식별 정보도 매번 새로 넣지 말고 재사용하도록 관리하는 게 좋습니다. 공식 HeyGen Skills는 아바타 정보를 AVATAR-<NAME>.md에 저장하고 영상 Skill이 이 파일을 읽도록 안내해요. 직접 구현하는 경우라면 확정 대본과 작업 기록을 연결해 두면, 어떤 입력으로 영상을 만들었는지 나중에 추적하기 쉬워집니다.

실행 절차는 이렇게 짜 볼 수 있습니다.

1. 대본의 사실관계와 용어를 검토하고 아바타·음성 정보를 확정합니다.
2. POST /v3/videos에 aspect_ratio: "9:16"을 지정해 생성을 요청하고, 반환된 작업 ID를 대본과 함께 기록합니다.
3. GET /v3/videos/{video_id}로 상태를 조회하거나 웹훅으로 완료·실패를 확인합니다.
4. 완료된 결과를 내려받아 저장한 뒤 검수합니다.

4번에서 링크만 적어 두고 넘어가면 곤란해요. 결과 URL에는 유효기간이 있기 때문입니다. 작업 ID는 처리 상태를 추적하는 데 쓰이고, 저장해 둔 파일은 검수와 후속 사용에 쓰이니 둘 다 남겨 두세요.

완성본 판단 기준: 자막과 발음, 그리고 요청 형식

완성본을 볼 때는 세 가지를 확인합니다. 음성이 확정 대본과 일치하는지, 기술 용어를 의도대로 발음하는지, 세로 화면에서 자막이 제대로 나오는지예요. 영문 제품명과 약어는 특히 음성과 화면 표기를 나눠서 보세요. HeyGen 브랜드 용어집의 발음 규칙은 생성 음성에는 적용되지만 자막에는 적용되지 않거든요.

자막 파일을 만드는 것과 영상에 자막을 입히는 것은 서로 다른 처리입니다.

SRT 파일이 생성됐다고 안심하지 말고 최종 영상을 직접 열어 자막이 표시되는지 확인하세요. 세로 화면에서 글자가 잘리거나 핵심 화면을 가리지는 않는지도 함께 봐야 합니다. 반복해서 나오는 오류는 Skills의 표현·검수 규칙에 반영해 두면 다음 제작에서도 같은 기준을 쓸 수 있어요. 비공개 아바타를 쓴다면 대상자의 동의 절차를 초기 설정 단계에 넣어 두어야 합니다.

구현을 마무리할 때는 요청 형식과 재생성 비용을 마지막으로 점검합니다. 현재 Digital Twin 가이드를 보면 v3는 caption을 객체로 받고, caption: true를 보내면 검증 오류가 납니다. 자막은 기본값이 꺼짐이라 원하는 처리 방식을 명시해 줘야 해요. 실패한 작업의 재생성 비용이 어떻게 처리되는지도 확인해 두세요. 편당 비용을 계산할 때는 재생성 횟수까지 포함하는 편이 합리적입니다.

한국어 품질, 처리 시간, 편당 비용은 결국 실제로 쓸 대본과 본인 계정 조건으로 측정해 봐야 알 수 있습니다.