솔라피 시작하기

가이드

Creatomate

작성일 2026.03.20 | 수정일 2026.03.20

Creatomate

Creatomate API를 사용하여 비디오와 이미지를 프로그래밍 방식으로 생성하는 노드입니다. 템플릿 기반 렌더링과 소스 기반 렌더링을 모두 지원합니다.

주요 기능

Render (렌더링)

Operation	설명
Render from Template	미리 만들어둔 템플릿으로 비디오/이미지 렌더링
Render from Source	JSON 소스 객체를 직접 정의하여 렌더링
Get Render Status	렌더링 작업 상태 조회
List Renders	전체 렌더링 작업 목록 조회

Template (템플릿)

Operation	설명
Get	템플릿 ID로 특정 템플릿 조회
List	전체 템플릿 목록 조회

설정 항목

Render from Template

항목	타입	기본값	설명
Template ID	string	-	렌더링에 사용할 템플릿 ID (필수)
Modifications	JSON	`{}`	템플릿 요소에 적용할 수정 사항 (텍스트, 이미지 등)
Wait for Completion	boolean	`true`	렌더링 완료까지 대기 여부

Render from Source

항목	타입	기본값	설명
Output Format	options	`mp4`	출력 형식 (MP4, GIF, JPEG, PNG)
Width	number	`1920`	출력 너비 (px)
Height	number	`1080`	출력 높이 (px)
Duration	number	`10`	영상 길이 (초, 비디오/GIF만 해당)
Frame Rate	number	`30`	프레임 레이트 (비디오/GIF만 해당)
Elements	JSON	`[]`	렌더링할 요소 배열 (텍스트, 이미지, 비디오, 도형 등) (필수)

추가 옵션 (Render from Source)

항목	타입	기본값	설명
Background Color	string	`#000000`	배경색 (HEX)
Fill Color	string	`#000000`	기본 채우기 색상
Mute	boolean	`false`	오디오 음소거 여부
Snapshot Time	number	`0`	스냅샷 시점 (이미지 출력 시)

공통 옵션

항목	타입	설명
Webhook URL	string	렌더링 완료 시 알림을 받을 웹훅 URL
Tags	string	렌더링 작업 정리용 태그 (쉼표 구분)

Template 조회

항목	타입	기본값	설명
Template ID	string	-	조회할 템플릿 ID (Get)
Limit	number	`50`	최대 반환 개수 (List, 1~100)
Tags	string	-	필터링할 태그 (List)

인증 정보

Creatomate API 키가 필요합니다. 자세한 설정 방법은 Creatomate API 인증 설정 가이드를 참고하세요.

사용 예시

템플릿으로 썸네일 이미지 생성

Creatomate 노드의 Resource를 Render, Operation을 Render from Template으로 설정합니다.
Template ID에 미리 만들어둔 썸네일 템플릿 ID를 입력합니다.
Modifications에 변경할 텍스트나 이미지를 JSON으로 지정합니다.

{
  "Text-1": {
    "text": "오늘의 뉴스 요약"
  },
  "Image-1": {
    "source": "https://example.com/background.jpg"
  }
}

소스 기반으로 프로모션 비디오 생성

Resource를 Render, Operation을 Render from Source로 설정합니다.
Output Format을 MP4, Width/Height를 1920x1080으로 설정합니다.
Elements에 텍스트, 이미지 등 요소를 JSON 배열로 정의합니다.

참고 사항

AI 도구(Tool)로 사용 가능합니다 (usableAsTool: true).
Creatomate 대시보드에서 템플릿을 미리 디자인하면 Modifications만으로 동적 콘텐츠를 생성할 수 있어 편리합니다.
Wait for Completion을 false로 설정하면 렌더링을 비동기로 실행하고, 이후 Get Render Status로 결과를 확인할 수 있습니다.
Creatomate 공식 문서에서 Elements 구조와 지원 속성을 확인할 수 있습니다.