한 명 또는 두 명의 인물에 초점을 맞춘 AI 비디오 워크플로우 구축하기

AI 비디오 도구가 알려진 레퍼런스 장면을 기반으로 구축될 때, 입력 양식 자체가 제품의 일부가 됩니다. 사용자는 시스템이 이미 알고 있는 안무를 설명하는 프롬프트를 작성할 필요가 없습니다. 그들은 단지 한 가지 질문에 답하기만 하면 됩니다. 즉, 각 역할에 어떤 사람이 등장해야 하는가?

저는 이러한 아이디어를 바탕으로 Rumpelstiltskin AI Video를 만들었습니다. 이 도구는 한 명 또는 두 명의 인물 사진을 사용하여 Rumpelstiltskin의 발끝으로 걷는(tiptoe) 춤 비디오의 개인화된 버전을 생성합니다. 레퍼런스 장면이 안무와 카메라 방향을 제공하고, 업로드된 인물 사진들이 캐릭터를 제공합니다.

1. 캐릭터 매핑을 명시적으로 만들기

UI는 두 가지 모드를 가집니다:

• 댄서만 (Dancer Only): 한 장의 인물 사진이 발끝으로 걷는 무용수(tiptoe dancer)를 대체하고, 원래의 처녀(maiden)는 장면 안에 남아 있습니다.
• 무용수 & 처녀 (Dancer & Maiden): 두 개의 별도 인물 사진이 두 캐릭터를 대체합니다.

이러한 구분은 빈 프롬프트 상자보다 더 유용합니다. 또한 백엔드에 작고 예측 가능한 입력 모델을 제공합니다: photoMode는 하나 또는 둘이며, 두 장의 사진 모드에서만 두 번째 파일이 필요합니다.

API는 각각 최대 20MB 용량의 JPG, PNG, WebP 파일을 허용합니다. 또한 작업(work)을 제공업체에 보내기 전에 원본 레퍼런스 지속 시간, 요청된 해상도 및 화면 비율을 검증합니다.

2. 생성 요청을 Idempotent하게 만들기

비디오 생성은 비동기적이며 사용자는 더블 클릭할 수 있습니다. 브라우저는 각 시도에 대해 idempotency key를 생성합니다. /api/generate/video 경로는 크레딧을 예약하기 전에 이 키를 주장하므로, 반복된 요청이 실수로 두 번째 유료 작업을 생성하는 것을 방지합니다.

응답은 request ID와 IN_QUEUE 상태를 반환합니다. 클라이언트는 그 다음 /api/generate/video/status를 확인하여 비디오가 준비되었다고 가정하기보다 실제 상태를 렌더링합니다. 보이는 상태는 의도적으로 간단합니다: queued, processing, completed, 또는 failed.

3. 제공업체 워크플로우를 단계별로 유지하기

서버는 초상화 파일과 무음 레퍼런스 비디오를 업로드하고, 이미지 안전성 검사를 실행한 다음, KIE를 통해 Seedance 2.5로 레퍼런스-투-비디오 작업을 제출합니다. 초기 제공자 요청은 generate_audio: false를 사용합니다. 비디오 작업이 완료되면, 별도의 오디오 단계에서 원본 레퍼런스 오디오가 결과물에 병합됩니다.

이러한 분리는 실패 상황을 더 쉽게 추론할 수 있게 합니다. 비디오 작업은 완료되지만 오디오 처리가 아직 보류 중일 수 있으며, 각 단계는 자체적인 상태와 오류 처리를 가집니다.

4. 크레딧을 예약으로 취급하기

유료 생성에는 480P에서 100 크레딧 또는 720P에서 170 크레딧이 사용됩니다. 서버는 사용자 세션과 사용 가능한 잔액을 확인하고, 필요한 금액을 공제한 다음, 제공자를 호출하기 전에 생성 요청을 기록합니다.

만약 제공자가 실패하거나 오디오 처리 단계가 완료될 수 없다면, 실패한 생성 경로는 생성 크레딧을 자동으로 반환합니다. 이는 현금 환불이 아닌 크레딧 반환입니다. UI는 청구 언어가 데이터베이스 동작과 일치해야 하므로 이를 직접적으로 명시합니다.

5. 제품 약속 범위를 좁게 유지하기

이 도구는 임의의 프롬프트로 임의의 비디오를 생성한다고 주장하지 않습니다. 이 도구는 하나의 레퍼런스 기반 변환만 수행합니다: 사용자의 초상화가 원본 발레 동작 속 캐릭터가 되는 것입니다. 사용자는 로그인하여 일회성 크레딧 팩을 구매하고, 480P 또는 720P를 선택하며, 처리가 성공하면 원본 레퍼런스 오디오가 포함된 MP4 다운로드를 받습니다.

이러한 제한적인 약속은 전체 구현에 영향을 미칩니다: 양식은 짧고, 유효성 검사는 엄격하며, 요청 상태는 표시되고, 가격 책정 문구는 무료 또는 무제한 생성기를 암시하지 않습니다.

워크플로우를 시도해 보고 싶다면, 제품은 airumpelstiltskin.org에서 이용 가능합니다.