스튜대학
메이크닷컴에 비디오스튜 API를 사용한 동영상 생성 자동화 프로세스 만들기

이번 포스팅에서는 메이크와 비디오스튜 API를 활용해서 동영상 자동 생성 프로세스를 구축하는 과정을 소개하고자 합니다.

시작하며

먼저 알려드릴 점은 이 포스팅에서는 메이크의 전반적인 사용방법은 다루지 않습니다. 메이크에서 어떤 식으로 소재를 발굴하고, 가공하는지는 유저의 의도에 따라 다양한 방식이 존재하기 때문이죠.

이 포스팅에서는 RSS를 통해 간단히 최신 뉴스기사를 수집하고, 기사 중 하나를 뽑아 비디오스튜 API를 활용해 자동으로 영상화하는, 비교적 간단한 흐름을 보여드립니다.

이 포스팅이 도움이 될 분들

이 포스팅은 대량의 텍스트 정보를 보유하고 있고 이것들을 모두 영상화하고자 하는 니즈가 있는 분들께 적절합니다.

하지만 메이크의 사용방법에 대한 기본 이해가 전제되어야 하고, 필요한 각 서비스들의 API를 연동하실 수 있을 정도의 기초적인 개발 실력이 필요하다는 점 미리 말씀드립니다.

예시

기업 HR팀의 텍스트 교육자료
언론사의 텍스트 기사
영상 채널 진출을 희망하는 헤비 블로거

또한 이 프로세스는 100% 자동화된 방식으로 한 방에 MP4 파일이 대량으로 만들어지고 검수 과정이 없기 때문에 도입을 검토하시는 분들의 주의가 필요합니다.

메이크에서의 전반적인 시나리오 구성

기본적으로 글을 생성하고 동영상 생성까지 하는 부분을 하나의 시나리오로 구성했습니다. 물론 유저의 니즈에 따라 이 부분은 더 디벨롭할 수 있는 여지가 많습니다.

그리고 나머지는 이렇게 만들어진 영상 파일을 웹훅으로 받아오는 부분입니다.

< 영상 자동화 파트와 웹훅 파트로 나눠서 시나리오를 생성 >

그러면 지금부터 동영상 생성 시나리오를 상세히 살펴보도록 할께요.

< 동영상 자동화를 위한 메이크 구성 >

전반적으로 흐름을 살펴보면 다음 단계로 진행됩니다.

RSS 모듈: 구글에서 최신 뉴스기사를 검색합니다. (스케쥴러로 매일 오전 9시 실행)
Text aggregator 모듈: 기사의 제목와 내용을 수집합니다.
ChatGPT 모듈: Keyword extractor의 역할을 하며 본문에서 Pixabay 이미지 검색을 위한 주요 키워드들을 추출합니다.
Pixabay API (HTTP 모듈): 각 키워드별로 이미지 URL을 가져옵니다.
ChatGPT 모듈: 앞서 추출된 기사를 AI보이스가 읽기 좋은 형태의 유튜브 스크립트로 변환하고 비디오스튜 API가 받을 수 있는 형태의 JSON으로 변환합니다.
Parse JSON 모듈: 최종 응답 형태의 JSON으로 정리합니다. (안정성 보장을 위해)
Videostew API (HTTP 모듈): 작성된 JSON 스크립트를 미리 지정한 템플릿에 넣어 영상 생성을 요청합니다.

이 포스팅에서 핵심이 되는 비디오스튜 API는 아래와 같이 POST 형식으로 https://videostew.com/api/automations 주소를 호출할 수 있는데요.

< 메이크에서 비디오스튜 API 호출하기 >

기본적으로 해야하는 설정들을 먼저 알아보겠습니다.

비디오스튜 API 기본 설정

비디오스튜 오토메이션 API 문서에는 플레이그라운드가 있어서 직접 테스트 API키를 통해 테스트를 진행해볼 수 있습니다.

< 비디오스튜 개발자 문서 중 오토메이션의 플레이그라운드 >

처음 진입하게 되면 테스트를 위한 키를 발급받은 뒤 위와 같은 화면이 보이게 됩니다. 여기 Injector의 형식대로 스크립트를 작성해서 오토메이션 API를 호출하면 되는데요.

Injector는 화면에 보여지는 모든 요소를 직접 지정할 수 있을만큼 자유도가 높습니다만, 심플 버전으로 간단하게 스크립트만 입력하는 것도 가능합니다.

비디오스튜 API 키 발급하기

메이크 연동을 위해서는 테스트 키로는 진행이 불가능하고 API 키 발급이 필요합니다. 비디오스튜 개발자 센터에서 새로운 앱을 생성해서, API 키를 발급받을 수 있습니다.

< 비디오스튜 비디오 오토메이션 API를 위해 앱 생성하기 >

이제 POST 방식으로 API를 호출할 때 보내줄 값들을 하나씩 알아보도록 하겠습니다.

Header 필수 전달 값

헤더에는 세 가지 정보가 필수로 전달되어야 합니다.

 "headers": [
            {
                "name": "x-api-key",
                "value": "{Your Videostew API Key}"
            },
            {
                "name": "x-token",
                "value": "{Your Videostew token value}"
            },
            {
                "name": "x-nounce",
                "value": "{random number}"
            }
        ]

Payload 전체 전달 값

플레이그라운드에 있는 모든 값들을 메이크에서는 아래와 같은 형식으로 작성할 수 있습니다.

{
  "payload": {
    "injector": {
      "data": {... Slide details ...}
    },
    "baseProjectId": "{Your Base Project Id}",
    "webhookUrl": "https://hook.us2.make.com/>{Your Make Webhook URL}",
    "webhookType": "json",
    "webhookHeader": "x-make-apikey: {Your Make Webhook API Key}"
  }
}

baseProjectId 는 data 구조를 간단하게 하기 위해 사용하는 것을 권고드리고, webhookUrl 과 webhookType , webhookHeader 는 메이크에서 웹훅으로 동영상 렌더링 후 MP4 파일 주소를 전달하기 위해 필요합니다.

슬라이드 구성 데이터 값 형식 이해하기

아래는 제가 메이크에서 실제 생성하는 JSON 형식 예시입니다.

    {
        "title": "Rotating Door",
        "slides": [
            {
                "image": "https://pixabay.com/get/.....jpg",
                "text": [
                    {
                        "label": "head-text",
                        "content": "Rotating Door"
                    },
                    
// ellipsis ...

            {
                "image": "https://pixabay.com/get/.....jpg",
                "text": [
                    {
                        "label": "head-text",
                        "content": "Rotating Door"
                    },
                    {
                        "label": "body-text",
                        "content": "Next time you use one, remember its clever purpose and history!"
                    }
                ]
            }
        ]
    }

slides 객체 안에 배열로 여러 개의 슬라이드 정보를 전달할 수 있는데요. 각 슬라이드마다 여러 개의 텍스트, 이미지, 동영상 정보를 담을 수 있습니다.

위 예시에서 텍스트 요소의 label 을 head-text 와 body-text 라고 제가 임의적으로 지정을 했는데요. 이는 제가 사용하는 템플릿에서 본문 슬라이드에 요소명칭을 그대로 가져온 것입니다.

전달하는 키 값 중에 baseProjectId 가 있는데 여기에 쓰이는 템플릿을 아래 이미지처럼 미리 준비해두었죠.

< 비디오 오토메이션 API를 쉽게 사용하기 위해 미리 만들어둔 템플릿 >

템플릿을 미리 잘 준비해두면 JSON으로 전달해야 하는 규격이 간소화되기 때문에 좀더 간단하게 연동 프로세스를 설계할 수 있습니다.

이 템플릿에서는 썸네일 이미지로 쓰일 Title 슬라이드, 오프닝 애니메이션이 들어간 intro 슬라이드, 그리고 스크립트가 들어갈 본문 슬라이드와 마지막 CTA 메세지를 넣기 위한 outro 슬라이드로 구성되어 있습니다. (나만의 템플릿 가이드를 통해서 좀더 자세하게 알아보실 수 있어요.)