Руководство по использованию
Создание музыки для рекламы электронной коммерции с помощью lyria-3.5 (а не изображений товаров)
lyria-3.5 — это модель генерации музыки по тексту, а не изображений: вот как реально использовать её для видеороликов о товарах и рекламы в электронной коммерции.
Lyria 3.5 создаёт музыку, а не фотографии товаров — вот правильный способ применения в электронной коммерции
Если вы искали «lyria-3.5 изображения товаров», короткий ответ таков: lyria-3.5 — это модель hiapi для генерации музыки по тексту — она не может создавать фотографии товаров. У неё нет вывода изображений, нет поля image_urls, и в её схеме вообще нет ничего, связанного с визуальным контентом. Её настоящее предназначение — фоновая музыка и саундтреки, и для продавцов электронной коммерции это как раз реальная и не полностью удовлетворённая потребность: каждому видеоролику о товаре, рекламе и короткому видео для соцсетей нужен саундтрек, а лицензионная музыка из библиотек обходится медленнее и дороже, чем ожидает большинство команд.
Это руководство показывает действительно рабочий сценарий: генерацию свободной от роялти фоновой музыки для видеороликов о товарах и рекламы в электронной коммерции с помощью lyria-3.5, включая реальный запрос, реальный ответ и реальный трек, созданный нами для этой статьи.
Почему этот сценарий подходит для lyria-3.5
Официальное описание модели lyria-3.5 на hiapi прямо указывает рекламу как предполагаемый вариант использования — наряду с подкастами и инди-поп демо. Это не наше натягивание, а собственная позиция платформы. Музыка для рекламы в электронной коммерции полностью попадает в эту категорию:
- Видео-демонстрации товаров (в стиле Shopify/TikTok Shop) требуют 15–40-секундной инструментальной подложки, которая не конкурирует с голосовым сопровождением.
- Платная реклама в соцсетях требует «весёлого, энергичного» настроения для передачи акции или запуска новинки, избегая при этом лицензионных сложностей.
- Фоновые плейлисты магазина (прямые трансляции с продажами, видео в приложении) требуют разнообразия без необходимости платить за синхронизационную лицензию за каждый трек.
Lyria 3.5 может за примерно минуту сгенерировать полный инструментальный трек по текстовому запросу (или вокальный трек, если вы предоставите текст песни), за 0,09 доллара за песню — достаточно дёшево, чтобы для каждой кампании генерировать несколько вариантов и выбирать лучший, что и является правильным способом использования генеративных музыкальных моделей: как черновик, а не как одноразовый финальный материал.
Одна реальная генерация: запрос, запрос к API, ответ
Ниже — точный запрос, который мы использовали, и точный трек, который он сгенерировал — без монтажа и без выбора из партии.
Запрос:
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
Запрос к API (унифицированный асинхронный API задач hiapi):
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 варианта для каждого запроса, а затем выбирайте тот, который лучше всего подходит для вашего монтажа, вместо того чтобы пытаться довести один запрос до совершенства с первого раза.
- Повторно размещайте перед публикацией. URL вывода
temp.hiapi.aiистекает — не ссылайтесь на него из онлайн-магазина или рекламы; скачайте и разместите на своём CDN. - Держите запрос сосредоточенным на настроении и инструментарии. «Upbeat», «warm bass», «no vocals» и жанровые теги (electronic-pop, lo-fi, acoustic) более надёжно направляют вывод, чем попытки описать конкретную мелодию.
- Если вам нужны тексты песен или большая длительность, hiapi также предлагает lyria-3-pro (0,14 доллара за песню), которая генерирует полноценные песни длительностью до примерно трёх минут с поддержкой текстов и нескольких языков — её стоит попробовать, когда вы переходите от быстрой подложки для рекламы к музыкальной теме бренда.
Часто задаваемые вопросы
Может ли lyria-3.5 генерировать изображения товаров для листингов электронной коммерции?
Нет. Lyria 3.5 — это модель генерации музыки по тексту, без вывода изображений. Для фотографий товаров используйте модели изображений на hiapi, например gpt-image-2.
Сколько стоит один трек lyria-3.5? 0,09 доллара за сгенерированную песню, оплата за задачу независимо от того, как в итоге используется трек.
Сколько времени занимает генерация? В наших тестах от отправки задачи до готового загружаемого трека проходит около минуты.
Могу ли я получить вокал вместо инструментальной музыки?
Да — передайте свой lyrics в запросе вместо (или вместе с) prompt настроения/жанра.
Свободен ли вывод от роялти для коммерческой рекламы? Треки генерируются специально по вашему запросу, а не являются лицензионными образцами — относитесь к ним как к любому AI-сгенерированному коммерческому материалу от hiapi: после генерации вы можете использовать их в рекламе, но размещайте их самостоятельно, поскольку URL доставки истекает.
Связанные ссылки
- Страница модели lyria-3.5 — актуальные цены, схема и пробная площадка.
- Цены hiapi — сравните lyria-3.5 со всеми другими аудио-, изображение- и видеомоделями.
- Документация API hiapi — полный справочник
/v1/tasksдля асинхронной генерации всех типов моделей. - minimax-music-3 API: руководство по curl и Python — вторая музыкальная модель, если вам нужны более длинные или стилистически иные треки.
Готовы попробовать? Получите ключ API из вашей панели управления и сгенерируйте свой первый трек с помощью запроса выше — это один вызов и минутный тест.
Похожие статьи
Все статьи →-
Руководство по использованию
Руководство по началу работы с seedream-5.0-pro/image-to-image: возможности, цены и ключевые моменты интеграции
Границы возможностей модели редактирования изображений ByteDance, принципы тарификации и практика инженерной интеграции
-
Руководство по использованию
Руководство по использованию seedream-5.0-pro text-to-image: границы возможностей, интеграция API и контроль затрат
Практический взгляд для разработчиков: от ключевых параметров до оценки стоимости $0.05 за изображение
-
Руководство по использованию
Руководство по началу работы с Hailuo 2.3 Fast для генерации видео из изображений: границы возможностей, цены и практика интеграции
Ключевые моменты выбора и интеграции модели MiniMax для генерации видео из изображений для разработчиков