HiAPI
블로그

사용 가이드

lyria-3.5로 이커머스 광고 음악 만들기(제품 이미지가 아님)

lyria-3.5는 텍스트-투-뮤직 모델이지 이미지 모델이 아닙니다——이커머스 제품 영상과 광고에 실제로 활용하는 방법을 소개합니다.

Sep 15, 2026
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이 만료되므로 직접 재호스팅해야 합니다.

관련 링크

시도해 볼 준비가 되셨나요? 대시보드에서 API 키를 받고 위 요청으로 첫 트랙을 생성해 보세요——한 번의 호출, 1분의 테스트입니다.

영구 AI 아티팩트로 빌드 시작하기

API 키를 받아 태스크 기반의 하나의 API로 이미지, 비디오, 오디오 모델을 호출하세요.

API 문서 보기