Mux, @mux/ai SDK로 내구성 있는 비디오 워크플로우를 구현한 방법

AI 워크플로우는 네트워크 타임아웃이나 API 제한 등으로 인해 실행 도중 실패하는 경우가 많다. 이 경우 처음부터 다시 시작하면 비용이 중복 발생하거나, 상태 관리를 위한 복잡한 코드를 직접 작성해야 하는 문제가 있다.

Mux는 이를 해결하기 위해 @mux/ai SDK를 개발하며 Vercel의 Workflow DevKit을 도입했다. 개발자가 복잡한 인프라 결정 없이도 쉽게 내구성(durability)을 확보할 수 있도록 하는 것이 핵심이다.

SDK는 세 가지 원칙을 따른다.

• 특정 인프라 요구사항 없음
• 선택적 내구성(Opt-in durability) 제공
• 익숙한 JavaScript 패턴 유지

"use workflow" 및 "use step" 지시어를 통해 코드 변경 없이도 자동 재시도, 상태 유지, 관측성을 제공한다. 일반 Node.js 환경에서는 아무런 영향을 주지 않는 no-op으로 동작하며, Workflow DevKit 환경에서 실행될 때만 강력한 내구성을 보장한다.

이를 통해 이미 완료된 단계의 비용을 낭비하지 않고, 서버리스 함수의 타임아웃 제한 없이 긴 작업도 안정적으로 수행할 수 있다. 또한 fetchTranscriptForAsset와 같은 저수준 작업 단위인 primitives를 제공하여, 개발자가 이를 자신의 워크플로우에 개별 단계로 쉽게 통합할 수 있도록 지원한다.