MCP API — 오디오 / BGM

개요

MCP로 영상 배경음악(BGM)을 생성하고 최종 영상에 믹싱하는 과정을 다룹니다. 프로바이더는 Stable Audio 2.5 (fal.ai)이며 create_bgm 도구 하나로 생성부터 콜백까지 처리합니다.

create_bgm

프롬프트와 길이를 지정하면 AI가 배경음악 WAV 파일을 생성합니다. create_clip과 동일하게 비동기로 동작하며 taskId를 반환합니다.

파라미터

• prompt (필수) — BGM 설명 (영어 권장). 자동으로 ", seamless loop" 접미사가 붙어 루프 친화적 생성물이 나옵니다.
• secondsTotal (필수) — 1~190초. 최종 영상 길이에 맞추는 것을 권장합니다.
• numInferenceSteps (선택) — 4~8, 기본 8. 높을수록 품질 ↑ 속도 ↓
• guidanceScale (선택) — 1~25, 기본 1. 높을수록 프롬프트 충실도 ↑ 창의성 ↓
• seed (선택) — 재현성 시드
• workflowId (선택) — 대시보드 워크플로우와 연동

프롬프트 예시

• "upbeat cinematic orchestral, 120 bpm, inspirational"
• "lo-fi hip hop, relaxed, jazz piano, 85 bpm"
• "epic trailer music, tension build, strings and percussion"
• "ambient electronic, dreamy pad, 90 bpm, ethereal"

비용

500 코인 (길이 무관, 실패 시 자동 환불)

출력

• 44.1kHz 스테레오 WAV
• 최대 190초
• 상업 라이선스 OK
• Supabase Storage에 자동 업로드됨 (bgm_url에 public URL 저장)

영상 합성 시 자동 믹싱

워크플로우 그래프에서 BGM 노드를 compose 노드에 연결하면 compose_video 실행 시 자동으로 믹싱됩니다. 기본 처리:

1. 크로스페이드 루프

BGM 길이가 영상보다 짧을 때, 루프 경계 0.5~1초 구간을 겹쳐 자연스럽게 이어 붙입니다.

2. 영상 끝 페이드 아웃

영상 종료 1~2초 구간에 BGM 볼륨을 서서히 0까지 감소시킵니다 (기본 fade_out_ms: 1500).

3. 볼륨 덕킹

원본 클립 오디오(Veo3/Seedance/Kling 자동 생성)가 있으면 BGM 볼륨을 자동 감쇠합니다 (기본 -12dB).

예제 워크플로우

1. create_workflow로 workflowId 생성
2. create_clip으로 30초 영상 제작 (여러 씬)
3. create_bgm으로 30초 BGM 생성

   {
     "prompt": "upbeat cinematic orchestral, inspirational, 120 bpm",
     "secondsTotal": 30,
     "workflowId": "wf_..."
   }

4. get_job_status 폴링으로 BGM 완료 대기 (bgm_url 확인)
5. compose_video 호출 — 워크플로우에 BGM 노드가 연결돼 있으면 자동 믹싱

참고

LTX-2.3 계열 모델은 오디오 미지원이라 BGM이 특히 중요합니다. Veo3/Seedance/Kling은 자동 오디오 생성이 있으므로 BGM을 덕킹으로 레이어링하는 것을 권장합니다.