사용 가이드
HiAPI에서 mureka-9.5로 이커머스 제품 영상용 사용자 정의 가사 노래 BGM 생성하기
개발자 가이드: 제품 카피를 광고용 음악으로 변환하고 영상에 믹싱하기
이 페이지에서
제품 영상에 기성 BGM보다 사용자 정의 노래가 나은 이유
기성 음악은 저렴하고 즉시 사용할 수 있다는 점에서는 이미 해결된 문제지만, 이커머스에서는 잘못된 문제를 해결합니다. 라이선스 트랙은 정의상 범용적입니다. 제품이 존재하기 전에 작곡되었고, 제품명도, 판매 포인트도, 행동 유도 문구도 담고 있지 않습니다. 15초 피드 영상에서 시청자는 처음 3초만 듣고 넘길 수 있습니다. 범용 음악은 설득력이 아니라 채우기일 뿐입니다.
mureka-9.5/lyrics-to-song 같은 가사-노래 변환 모델은 이 결정의 경제성을 바꿉니다. 가사를 제공하면 모델이 노래로 부른 트랙을 반환하며, 제품명을 직접 언급하고 혜택을 전달합니다. 배경 음악과의 핵심 차이는 트랙 자체가 카피 채널이 되어, 시청자가 자막을 전혀 읽지 않아도 작동한다는 점입니다.
다음 경우에는 기성 BGM을 사용하세요:
- 영상이 순수 시각적 쇼케이스이고 카피가 화면에 표시되는 경우;
- 매일 수십 개의 변형이 필요하고 브랜드 톤이 제약이 아닌 경우;
- 제품에 노래로 만들 만한 이름, 판매 포인트, 혜택이 없는 경우.
다음 경우에는 생성된 가사 트랙을 사용하세요:
- 제품명이나 짧은 판매 포인트가 후킹 요소인 경우;
- SKU마다 재사용 가능한 광고 소재를 제작하고 식별 가능한 사운드 아이덴티티를 원하는 경우;
- 음악을 다시 라이선스하는 대신 텍스트를 편집해 반복 개선할 수 있는 징글 같은 자산이 필요한 경우;
- 곡 라이브러리 검색이 아니라 프롬프트로 템포와 무드를 제어하고 싶은 경우.
이 트레이드오프는 솔직합니다. 생성은 요청과 렌더링 단계를 추가하며, 보컬演唱은 기악 반주보다 더 많은 품질 관리가 필요합니다. 이 가이드의 나머지 부분은 이 트레이드오프를 엔지니어링 문제로 다루고 재사용 가능한 파이프라인을 제시합니다.
개발자를 위한 실용적 프레임워크: 가사 트랙을 썸네일, 짧은 영상과 나란히 제품 미디어 파이프라인의 또 하나의 생성 자산으로 취급하세요. 입력(제품 속성), 렌더링 단계(API 호출), 그리고 전달 전에 반드시 통과해야 하는 출력이 있습니다.
제품 카피를 노래할 수 있는 가사로 변환하기
광고 가사-노래 변환에서 가장 흔한 실패는 마케팅 카피를 그대로 제출하는 것입니다. 노래하는 모델은 주는 대로 다 부릅니다. 40단어 기능 목록까지도요. 그리고 결과물은 15초 클립에 맞지 않습니다. 해결은 API 호출 전에 이루어집니다. 제품 카피를 고정 구조의 짧은 문장으로 압축하세요.
4슬롯 구조
각 제품을 네 슬롯에 매핑하세요:
- 정체성 — 제품명과 카테고리 힌트("보온되는 세라믹 머그").
- 판매 포인트 — 목록이 아닌 구체적 결과("커피가 정오까지 따뜻함").
- 증거 또는 차별점 — 단 하나의 감각적 또는 소재적 세부 사항.
- 행동 유도 — 매장과 연결된 짧은 명령문.
각 슬롯은 한두 줄 가사가 됩니다. 문장을 짧게 유지하세요. 한 줄에 약 5~9음절이 가창성의 안전한 목표이며, 보컬 프레이즈를 몇 초 오디오 안에 유지할 수 있습니다. 가격 속 숫자, 법적 면책 조항, 괄호 절은 피하세요. 노래하기 어렵고 자주 뭉개집니다.
프로그래밍 방식으로 가사 도출하기
슬롯을 제품 레코드의 구조화된 필드로 저장한 뒤, 자유 형식 문자열 연결이 아니라 템플릿으로 조립하세요:
[verse]
{identity_line}
{benefit_line}
[chorus]
{product_name}, {benefit_short}
{cta_line}
템플릿은 카탈로그 데이터와 모델 사이의 계약입니다. 카피라이터가 한 줄을 다시 쓰면 필드만 바뀝니다. 템플릿은 안정적으로 유지되므로 출력 길이와 구조가 SKU 간에 예측 가능하게 유지됩니다.
길이 예산
렌더링 전에 줄 수를 기준으로 길이를 추정하세요. 15초 광고는 한 절과 짧은 후렴을 편안히 담을 수 있고, 30초 광고는 후렴을 두 번째 반복할 수 있습니다. 조립된 가사가 예산을 초과하면 행동 유도 대신 증거 슬롯을 먼저 삭제하세요. 예산 검사를 생성기의 어서션으로 작성하면 장황한 제품 설명이 조용히 사용 불가능한 트랙을 만들어내는 일을 막을 수 있습니다.
마지막으로 원본 제품 카피와 도출된 가사를 나란히 두세요. 트랙이 돌아왔을 때 단어가 잘못 발음되면 원본 필드 때문인지 표현 때문인지 알아야 합니다.
mureka-9.5/lyrics-to-song용 HiAPI 요청 구성하기
모든 모델 접근은 HiAPI 통합 인터페이스를 통해 이루어지므로 요청 형태는 다른 미디어 모델에 사용하는 것과 같습니다. HiAPI 키로 인증하고, mureka-9.5/lyrics-to-song 모델 식별자를 지정하고, 가사 페이로드와 스타일 지침을 전달합니다.
요청 구조
최소 요청은 다음을 포함합니다:
- model —
mureka-9.5/lyrics-to-song. - lyrics — 이전 단계에서 조립한, 구간 태그가 있는 텍스트.
[verse]/[chorus]태그를 유지하세요. 모델이 곡 구조를 구성하는 방법을 알려줍니다. - 스타일 프롬프트 — 장르, 무드, 템포, 편곡을 형용사나 구문으로 표현(예: "bright indie pop, mid tempo, acoustic guitar, clean female vocal").
- 기악 플래그 — 보컬 가사가 필요할 때는 false로 유지하세요. 순수 반주만 필요할 때만 true로 설정합니다.
{
"model": "mureka-9.5/lyrics-to-song",
"lyrics": "[verse]\nHand-thrown stoneware, morning light\n[chorus]\nKeep the heat till the afternoon\nShop the stoneware line today",
"style": "warm indie pop, mid tempo, clean vocal",
"instrumental": false
}
응답 처리
대부분의 워크플로에서 호출은 인라인 바이트가 아니라 오디오 자산 참조를 반환합니다. 이를 비동기 작업으로 취급하세요. 제출하고, 폴링하거나 완료 신호를 기다린 뒤, 오디오를 {sku}/{variant}/{hash-of-lyrics-and-style} 키로 자체 버킷에 다운로드합니다. 해시는 렌더링을 멱등하게 만들어 배치를 다시 실행해도 중복 자산이 생기지 않기 때문에 중요합니다.
호출을 세 가지 책임을 지는 얇은 클라이언트로 감싸세요. 일시적 장애에 대한 백오프 재시도, 반환된 길이가 예산 내인지 검증, 요청 페이로드를 자산과 함께 기록해 재현 가능하게 만드는 것입니다. 실패한 렌더링이 영상 조립을 막지 않게 하세요. 오류를 점검하는 동시에 해당 제품 라인은 캐시된 트랙으로 폴백하세요.
스타일 프롬프트를 요청 빌더에 하드코딩하지 말고 각 캠페인의 구성 파일에 두세요. 이렇게 하면 계절 업데이트가 코드 변경이 아니라 구성 변경이 되고, 캠페인의 모든 SKU가 일관된 사운드를 유지합니다.
생성된 트랙을 영상 파이프라인에 믹싱하기
생성된 트랙은 원시 크리에이티브 자산입니다. 최종 편집본에는 예측 가능한 길이와 레벨이 필요합니다. 대부분의 문제는 생성 시점이 아니라 여기서 발생합니다.
길이를 편집본에 맞추기
반환된 오디오 길이를 측정하고 영상 타임라인과 비교하세요. 두 가지 안전한 전략이 있습니다:
- 음악 경계에서 자르기 — 보컬 프레이즈가 끝나는 지점에서 자르고 약 300~500ms 페이드아웃을 적용해 꼬리가 딸깍 소리를 내지 않게 합니다.
- 비트 정렬 지점에서 루프 — 트랙이 영상보다 짧으면 임의 타임스탬프가 아니라 후렴 경계에서 루프해 들리는 이음새를 피합니다.
트랙이 영상보다 확실히 길면 단순히 잘라내지 말고 더 짧은 가사 예산으로 다시 렌더링하세요. 단어 중간에서 자르는 것이 보컬 광고에서 가장 눈에 띄는 실패입니다.
믹싱 전 레벨
음악을 내레이션(있는 경우) 대비 일관된 목표 라우드니스로 정규화하고, 사이드체인 또는 간단한 볼륨 자동화 곡선으로 음성 아래에서 음악을 낮추세요. 영상에 내레이션이 없으면 트랙을 더 크게 할 수 있지만 플랫폼 라우드니스 정규화가 눌러버리지 않도록 여유를 두세요. 영상 시작 부분에 짧은 페이드인을 적용해 자동 재생 시 오디오가 갑자기 시작되지 않게 하세요.
믹싱
기존 인코딩 파이프라인(ffmpeg 또는 호스팅 트랜스코더)을 사용하고 오디오를 또 하나의 입력 스트림으로 취급하세요:
ffmpeg -i product.mp4 -i track.wav \
-filter_complex "[1:a]afade=t=in:st=0:d=0.4,afade=t=out:st=14.6:d=0.4[a]" \
-map 0:v -map "[a]" -c:v copy -c:a aac -shortest out.mp4
중요한 규칙은 영상 스트림을 재인코딩이 아니라 복사하는 것입니다. 그래야 음악을 교체해도 화질이 떨어지지 않습니다. 믹싱 단계를 페이드 지점과 루프 마커로 매개변수화해 15초와 30초 변형이 동일한 코드 경로에서 나오게 하세요.
생성된 트랙을 믹싱된 영상과 별도로 저장하세요. 크리에이티브를 업데이트할 때 곡을 다시 렌더링하지 말고 다시 믹싱하세요.
매장 배포 전 품질 점검
자동화할 수 있는 것은 자동화하고, 나머지는 들어보세요. 짧은 출시 전 체크리스트만으로 거의 모든 실패 모드를 잡을 수 있습니다.
자동 게이트
- 길이 — 해당 배치 위치의 목표 윈도 내(예: 광고 슬롯 상한).
- 라우드니스 — 적분 라우드니스가 플랫폼 예상 범위 내; 벗어나면 빌드 실패.
- 무음과 클리핑 — 의도치 않은 무음 구간 없음, 풀스케일 피크 없음.
- 자산 연결 — 트랙 해시, 가사 페이로드, 제품 레코드가 출력에 대해 모두 기록됨.
인간 게이트
- 가사 명료도 — 처음 듣는 사람이 한 번에 제품명을 알아들을 수 있는가? 아니면 템포를 늦추지 말고 문장을 단순화하세요.
- 발음 — 브랜드명과 낯선 단어는 흔한 희생양입니다. 알려진 목록과 하나씩 대조하세요.
- 브랜드 적합성 — 장르와 보컬 음색이 카테고리와 맞는가. 고에너지 트랙이 프리미엄이나 조용한 제품에 붙으면 오류로 보입니다.
- 타이밍 — 행동 유도가 제품이 아직 화면에 있을 때 나오는가, 페이드아웃 후가 아니라.
이 게이트를 배치가 아니라 변형별로 실행하세요. 백 개 배치 중 하나의 나쁜 발음이 바로 매장에 새어 나가는 경우입니다. 주어진 제품 라인의 최신 렌더를 가져와 연속 재생하는 작은 오디션 도구를 유지하세요. 몇 분이면 되고, 지표로는 발견할 수 없는 구조적 문제를 잡아냅니다.
점검이 실패하면 입력(가사 줄, 스타일 프롬프트, 길이 예산)을 고치고 동일한 캐시 키 입력으로 다시 렌더링해 새 자산이 이전 자산을 깔끔하게 대체하게 하세요.
제품 카탈로그로 확장하기
단일 메인 영상은 데모입니다. 카탈로그는 시스템입니다. 목표는 모든 트랙을 다시 듣지 않고도 규모에서 일관성을 유지하는 것입니다.
SKU가 아니라 제품 라인으로 배치하기
카테고리, 판매 포인트 형태, 브랜드 톤을 공유하는 SKU를 그룹화한 뒤 그룹마다 스타일 프롬프트 하나와 가사 템플릿 하나를 렌더링하세요. 그룹 내 변형은 채우는 필드만 다릅니다. 이렇게 하면 카테고리 페이지에서 사운드 일관성을 얻고 각 제품의 정체성을 유지하며 검토해야 할 서로 다른 프롬프트 수를 크게 줄입니다.
캐싱과 중복 제거
가사 페이로드, 스타일 프롬프트, 모델 버전의 해시로 각 자산의 키를 만드세요. 같은 입력은 캐시된 자산을 반환하고, 바뀐 필드만 새 렌더를 트리거합니다. 이렇게 하면 한 제품의 한 줄을 조정했을 때 카탈로그 재렌더링이 저렴해지고, 모든 크리에이티브에 영상 파이프라인이 참조할 안정적인 URL이 생깁니다.
큐와 백오프
제한된 동시성과 재시도가 있는 작업 큐로 렌더를 제출하세요. 카탈로그 새로고침은 버스트입니다. 큐가 이를 평탄화하고 곧 캠페인이 있는 제품을 우선 처리할 수 있게 합니다. 각 작업에 요청 페이로드를 기록해 실패한 렌더를 추측 없이 재현하세요.
크리에이티브 거버넌스를 가볍게 유지하기
템플릿과 스타일 프롬프트를 제품 데이터와 같은 저장소에서 버전 관리하세요. 이렇게 하면 후렴 템플릿 변경이 코드처럼 검토되고, 어떤 제품이 어느 템플릿 리비전으로 렌더링되었는지 정확히 볼 수 있습니다. 템플릿이 바뀌면 혼합 리비전이 매장에 공존하지 않도록 이전 자산을 폐기하세요.
제품 라인 하나로 시작해 가사에서 믹싱까지의 경로를 엔드투엔드로 검증한 뒤 카테고리별로 확장하세요. 구축한 파이프라인(구조화된 가사 필드, 멱등 HiAPI 요청, 믹싱 단계, 짧은 체크리스트)은 카탈로그가 커져도 그대로 유지됩니다. 바뀌는 것은 수량뿐입니다. 첫 요청을 연결할 준비가 되면 HiAPI에서 이 모델을 살펴보세요.