사용 가이드
lyria-3.5로 이커머스 광고 음악 만들기(제품 이미지가 아님)
lyria-3.5는 텍스트-투-뮤직 모델이지 이미지 모델이 아닙니다——이커머스 제품 영상과 광고에 실제로 활용하는 방법을 소개합니다.
Lyria 3.5는 제품 사진이 아닌 음악을 생성합니다——이커머스에 올바르게 활용하는 방법은 다음과 같습니다
"lyria-3.5 제품 이미지"를 검색해 보셨다면, 짧은 답은 이렇습니다: lyria-3.5는 hiapi의 텍스트-투-뮤직 모델로, 제품 사진을 생성할 수 없습니다. 이미지 출력도, image_urls 필드도 없으며, 스키마에 시각 관련 내용이 전혀 없습니다. 이 모델의 진짜 용도는 배경 음악과 사운드트랙이며, 이커머스 셀러에게는 이것이 바로 실제적이고 충분히 충족되지 않은 수요입니다. 모든 제품 영상, 광고, 소셜 클립에는 음악이 필요하지만, 라이선스 스톡 음악은 대부분의 팀이 예상하는 것보다 더 느리고 더 비쌉니다.
이 가이드는 실제로 가능한 사용 사례를 보여줍니다: lyria-3.5로 이커머스 제품 영상과 광고용 로열티 프리 배경 음악을 생성하는 방법으로, 실제 요청, 실제 응답, 그리고 이 글을 위해 생성한 실제 트랙을 포함합니다.
이 사용 사례가 lyria-3.5에 적합한 이유
hiapi의 lyria-3.5 공식 모델 설명은 광고를 명시적으로 의도된 사용 사례로 지목하며, 팟캐스트와 인디 팝 데모와 나란히 언급합니다. 이것은 우리의 억지스러운 해석이 아니라 플랫폼 자체의 포지셔닝입니다. 이커머스 광고 음악은 완전히 이 범주에 속합니다:
- 제품 데모 영상(Shopify/TikTok Shop 스타일)은 보이스오버 해설과 경쟁하지 않는 15–40초의 기악 반주가 필요합니다.
- 유료 소셜 광고는 프로모션이나 신제품 출시를 전달하기 위해 "경쾌하고 활기찬" 분위기가 필요하면서, 라이선스 번거로움을 피해야 합니다.
- 매장 배경 재생목록(라이브 커머스, 인앱 영상)은 트랙마다 동기화 라이선스 비용을 지불하지 않고도 다양성이 필요합니다.
Lyria 3.5는 텍스트 프롬프트로 약 1분 만에 완전한 기악곡(가사를 제공하면 보컬 트랙도 가능)을 생성하며, 곡당 0.09달러입니다——각 캠페인마다 여러 변형을 생성하고 가장 좋은 것을 고를 수 있을 만큼 저렴하며, 이것이 바로 생성형 음악 모델을 올바르게 사용하는 방법입니다: 일회성 최종 소재가 아닌 초안으로 활용하는 것입니다.
실제 생성 사례: 프롬프트, 요청, 응답
다음은 우리가 사용한 정확한 프롬프트와 그것이 생성한 정확한 트랙입니다——편집도, 배치에서 골라낸 것도 아닙니다.
프롬프트:
Upbeat modern electronic-pop instrumental for an e-commerce product ad, bright plucked synths, punchy four-on-the-floor beat, warm bass groove, optimistic and energetic mood, radio-ready polish, no vocals
요청(hiapi의 통합 비동기 작업 API):
curl -s -X POST https://api.hiapi.ai/v1/tasks \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "lyria-3.5",
"input": {
"prompt": "Upbeat modern electronic-pop instrumental for an e-commerce product ad, bright plucked synths, punchy four-on-the-floor beat, warm bass groove, optimistic and energetic mood, radio-ready polish, no vocals"
}
}'
이 요청은 즉시 작업 ID를 반환합니다. 음악 생성은 hiapi의 이미지 및 비디오 모델과 동일하게 비동기로 실행됩니다.
종료 상태까지 폴링:
curl -s https://api.hiapi.ai/v1/tasks/tk-hiapi-01M2HM4T0RG0XQNS6TFE9QF14V \
-H "Authorization: Bearer $HIAPI_API_KEY"
완료 후 응답(간추림):
{
"id": "tk-hiapi-01M2HM4T0RG0XQNS6TFE9QF14V",
"status": "success",
"output": [
{
"title": "Bright Shelf",
"url": "https://temp.hiapi.ai/7c6ttvrbpt/01M2HM4T0RG0XQNS6TFE9QF14V-0.m4a"
}
],
"expireAt": 1790050272
}
실제 결과를 여기에서 들어보세요: Bright Shelf——lyria-3.5 출력(.m4a). 이 링크는 임시 출력 URL로, 생성 후 약 7일 뒤 만료됩니다——파일을 보관하려면 직접 다운로드하여 재호스팅하세요. 이는 오디오를 포함한 모든 hiapi 작업 출력에 적용되는 표준 방식입니다: 작업이 완료되면 즉시 바이트를 가져와 자신의 버킷에 저장하세요.
모델이 스스로 트랙 이름을 "Bright Shelf"로 지정했습니다——lyria-3.5는 오디오와 함께 짧은 제목을 자동 생성하며, 캠페인용 음악 라이브러리를 정리하고 있다면 좋은 디테일입니다.
Python 동등 코드
import requests
import time
API_KEY = "your-hiapi-key"
BASE = "https://api.hiapi.ai/v1"
resp = requests.post(f"{BASE}/tasks", headers={"Authorization": f"Bearer {API_KEY}"}, json={
"model": "lyria-3.5",
"input": {
"prompt": "Upbeat modern electronic-pop instrumental for an e-commerce product ad, "
"bright plucked synths, punchy four-on-the-floor beat, warm bass groove, "
"optimistic and energetic mood, radio-ready polish, no vocals"
}
})
task_id = resp.json()["id"]
while True:
task = requests.get(f"{BASE}/tasks/{task_id}", headers={"Authorization": f"Bearer {API_KEY}"}).json()
if task["status"] in ("success", "fail"):
break
time.sleep(5)
if task["status"] == "success":
audio_url = task["output"][0]["url"]
audio_bytes = requests.get(audio_url).content
with open("bright_shelf.m4a", "wb") as f:
f.write(audio_bytes)
스키마: lyria-3.5가 실제로 받는 것
이 스키마는 의도적으로 좁게 설계되었습니다——텍스트-투-뮤직 모델이지 범용 오디오 툴킷이 아닙니다:
prompt(string)——lyrics를 직접 제공하지 않는 경우 필수입니다. 장르, 편곡, 리듬, 분위기를 설명하세요.lyrics(string, 선택 사항)——기악곡 대신 보컬 트랙을 원한다면 자신의 가사를 전달할 수 있습니다.
duration, image_urls, reference_audio 필드는 없습니다. 지원되지 않는 필드나 빈 페이로드를 보내면 조용히 무시되는 대신 검증 오류가 발생합니다——첫 통합 시 응답을 확인할 가치가 있습니다. 필드명이 잘못되었는지 즉시 알려주기 때문입니다.
"제품 이미지" 혼동에 관해 특별히: 팀 브리핑에 "lyria-3.5로 제품 이미지를 생성하라"고 되어 있다면, 그 지시는 잘못된 모델에 근거한 것입니다. 실제 제품 사진과 광고 비주얼에는 이미지 모델을 사용하세요——gpt-image-2는 hiapi에서 가장 많이 쓰이는 텍스트-투-이미지 모델로, 제품 이미지와 이미지 위 텍스트 처리에 강합니다. 이를 lyria-3.5와 함께 영상/광고 사운드트랙에 사용하면, 스톡 라이브러리 구독 없이 두 번의 API 호출로 제품 영상의 두 부분을 모두 커버할 수 있습니다.
프로덕션 고려 사항
- 모든 생성을 초안으로 취급하세요. 곡당 0.09달러이므로 각 프롬프트당 2–3개의 변형을 생성한 뒤 편집에 가장 잘 맞는 것을 고르세요. 단일 프롬프트를 첫 시도에 완벽하게 만들려고 하지 마세요.
- 게시 전 재호스팅하세요.
temp.hiapi.ai출력 URL은 만료됩니다——온라인 스토어나 광고에서 이 URL을 링크하지 마세요. 다운로드하여 자신의 CDN에 호스팅하세요. - 프롬프트는 분위기와 편곡에 집중하세요. "Upbeat", "warm bass", "no vocals" 및 장르 태그(electronic-pop, lo-fi, acoustic)가 구체적인 멜로디를 묘사하려는 것보다 출력을 더 안정적으로 유도합니다.
- 가사나 더 긴 길이가 필요하다면, hiapi는 lyria-3-pro(곡당 0.14달러)도 제공하며, 최대 약 3분의 완전한 곡을 생성하고 가사와 다국어를 지원합니다——빠른 광고 반주에서 브랜드 테마 음악으로 발전할 때 시도해 볼 가치가 있습니다.
자주 묻는 질문
lyria-3.5가 이커머스 리스팅용 제품 이미지를 생성할 수 있나요?
아니요. Lyria 3.5는 텍스트-투-뮤직 모델로 이미지 출력이 없습니다. 제품 사진에는 gpt-image-2와 같은 hiapi의 이미지 모델을 사용하세요.
lyria-3.5 트랙 하나에 얼마가 드나요? 생성된 곡당 0.09달러이며, 트랙을 최종적으로 어떻게 사용하든 작업 단위로 과금됩니다.
생성에 얼마나 걸리나요? 저희 테스트에서는 작업 제출부터 다운로드 가능한 트랙 완성까지 약 1분이 걸렸습니다.
기악곡 대신 보컬을 받을 수 있나요?
네——요청에 자신의 lyrics를 전달하여 분위기/장르 prompt를 대체(또는 함께 사용)할 수 있습니다.
출력이 상업 광고에 로열티 프리가 되나요? 트랙은 라이선스 샘플이 아닌 당신의 프롬프트에 맞춰 특별히 생성됩니다——hiapi의 모든 AI 생성 상업 소재와 동일하게 취급하세요: 생성 후 광고에 사용할 수 있지만, 전달 URL이 만료되므로 직접 재호스팅해야 합니다.
관련 링크
- lyria-3.5 모델 페이지——실시간 가격, 스키마, 체험 플레이그라운드.
- hiapi 가격——lyria-3.5를 다른 모든 오디오, 이미지, 비디오 모델과 비교하세요.
- hiapi API 문서——모든 모델 유형의 비동기 생성을 위한 완전한
/v1/tasks레퍼런스. - minimax-music-3 API: curl 및 Python 가이드——더 길거나 다른 스타일의 트랙을 원한다면 두 번째 음악 모델입니다.
시도해 볼 준비가 되셨나요? 대시보드에서 API 키를 받고 위 요청으로 첫 트랙을 생성해 보세요——한 번의 호출, 1분의 테스트입니다.
관련 글
모든 아티클 보기 →-
사용 가이드
seedream-5.0-pro/image-to-image 시작 가이드: 기능, 가격 및 연동 핵심 포인트
ByteDance 이미지 편집 모델의 기능 경계, 과금 방식 및 엔지니어링 연동 실무
-
사용 가이드
seedream-5.0-pro 텍스트-이미지 생성 입문 가이드: 능력 경계, API 연동 및 비용 관리
개발자를 위한 실무 관점: 파라미터 핵심부터 장당 $0.05 비용 추정까지
-
사용 가이드
Hailuo 2.3 Fast 이미지-투-비디오 입문 가이드: 성능 범위, 가격 및 연동 실무
개발자를 위한 MiniMax 이미지-투-비디오 모델 선택과 연동 핵심 포인트