배경 및 목적
최근 런웨이(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 내부에서 처리 가능.
감사합니다 🙇🏻♂️