배경 및 목적
최근 런웨이(Runway)에서 텍스트를 이미지로 변환하는 API를 제공하기 시작했습니다. 제공되는 3가지 API Endpoint가 간단한 수준이기는 하지만, Node SDK, Python SDK(Software Development Kit; 소프트웨어 개발 킷) 처럼, Make에서는 공식 앱은 현재 지원되고 있진 않습니다.
Make에서 비개발자분들도 HTTP 모듈을 통해 API를 연동할 수 있으나, 공식 모듈이 나올때까지 쉽게 접근 할 수 있도록 커스텀 앱을 만들어서 공유하고자 합니다.
Make에서 Runway API앱을 만들어 사용자들이 쉽게 API를 활용
API 연결 과정을 간소화하여 사용자들이 복잡한 HTTP 요청 구성 없이도 API를 사용
공식 앱이 출시될 때까지 임시적이지만 효과적인 해결
참고 자료
활용 툴
Runway API
Make
실행 과정
Runway API 분석
현재 제공되는 3가지 Runway API 스펙을 확인
# 현재 기본적인 API 구성을 아래와 같음
## 영상생성 Task Request
curl -X POST https://api.dev.runwayml.com/v1/image_to_video \
-d '{
"promptImage": "http://example.com",
"seed": 999999999,
"model": "gen3a_turbo",
"promptText": "string",
"watermark": false,
"duration": 5,
"ratio": "16:9"
}' \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {{ YOUR API KEY }}" \
-H "X-Runway-Version: 2024-09-13"
## Task Progress 및 완성된 영상 주소 확인
curl https://api.dev.runwayml.com/v1/tasks/{id} \
-H "Authorization: Bearer {{ YOUR API KEY }}" \
-H "X-Runway-Version: 2024-09-13"
## Task 취소 및 삭제 (영상파일을 Storage에서 삭제)
curl -X DELETE https://api.dev.runwayml.com/v1/tasks/{id} \
-H "Authorization: Bearer {{ YOUR API KEY }}" \
-H "X-Runway-Version: 2024-09-13"Make 커스텀 앱 생성
Base Structure 에 API 관련된 공통 부분을 설정
Connection 설정
Auth(API key)관련 정보를 설정
모듈 및 파라미터 설정
API스펙에 맞춰서 모듈 설정
API에 필요한 파라미터를 정의 및 설정
테스트
공유
커스텀 앱의 메인에 있는 Share public link 또는 invite users아래의 링크를 통해 공유가능
https://www.make.com/en/hq/app-invitation/6afbcbe5e6e1fe7ecc9fc9ceffc1a87c
결과 및 인사이트
내/외부 API의 Make 공식 모듈이 없는 경우 다양하게 활용 가능.
각종 시나리오에서 반복적으로 작업이 필요한 HTTP 모듈의 경우, 커스텀 앱으로 처리 가능.
예를 들어, "멍멍_"님의 내가 자주보는 유튜브 채널 자동으로 요약 받기(with make) 글에서 소개하신 "채널 ID 확인 : 핸들(@XXX)을 이용해 '채널 ID' 를 확인 가능" 부분을 YouTube API 커스텀 앱을 생성하여 HTTP 모듈 혹은 외부자원을 사용하지 않고 Make 내부에서 처리 가능.
감사합니다 🙇🏻♂️