Lyria 3 Pro
lyria-3-pro
Продвинутая модель генерации музыки от Google, способная создавать полноценные треки длительностью около 3 минут в стерео 48 кГц, понимает структуру секций — вступление, куплет, припев — и лучше следует промптам, чем Lyria 3
Попробовать lyria-3-pro
Ввод
Работы
Все работыВывод
audioЦены
lyria-3-pro per song
| Цена за единицу | $0.140 |
|---|
Краткое описание
lyria-3-pro — это модель генерации музыки по тексту от Google, предназначенная для разработчиков, которым нужны полноценные композиции, а не фрагменты. В промпте описываются жанр, инструменты, настроение, темп, текст песни и структура композиции, также можно указать временные метки для управления разбивкой на секции; кроме того, поддерживается управление направлением генерации с помощью до 10 изображений. Модель подходит командам, которые массово создают оригинальную музыку для видео, игр, социальных материалов и брендовых проектов: достаточно подключиться через единый интерфейс HiAPI.ai, чтобы встроить её в существующий производственный процесс.
Ключевые особенности
- Генерация структурно завершённых композиций — в промпте можно задать вступление, куплет, припев, бридж и другие секции, а также временные метки, чтобы получить полноценную песню с чёткими началом и концом, а не зацикленный фрагмент.
- Более точное следование промпту — версия Pro точнее воспроизводит жанр, инструменты и замысел аранжировки, что снижает затраты на многократные повторные попытки и корректировки.
- Управление направлением творчества с помощью изображений — за один запрос можно загрузить до 10 изображений в качестве референсов настроения и темы, перенося тональность визуальных материалов в генерацию музыки.
- Поддержка воспроизводимости через seed — можно передать параметр seed для воспроизводимых попыток генерации, что удобно для контроля переменных при итерациях.
Описание возможностей
Генерация музыки по тексту: опишите в промпте жанр, инструменты, настроение, темп, текст песни и структуру композиции, чтобы сразу получить готовый оригинальный аудиовыход.
Структурированное управление аранжировкой: в промпте можно задавать временные метки вида [0:00 - 0:30], ограничивая начало и конец секций, чтобы результат соответствовал заданному повествовательному ритму.
Управление изображениями: передайте от 1 до 10 изображений в качестве источника вдохновения, чтобы задать настроение, тему и общее направление аранжировки; сами изображения не становятся визуальными материалами выходных данных.
Воспроизводимая генерация: параметр seed используется для воспроизводимой генерации, что облегчает сравнение и корректировку результатов при одинаковых настройках, но не гарантирует полной детерминированности.
Сценарии применения
- Видеопроизводственные команды: музыка по раскадровке — опишите ритм кадров и настроение в промпте, чтобы получить оригинальную музыку, соответствующую длительности видео, и сразу перейти к монтажу и постобработке.
- Разработчики игр: индивидуальная фоновая музыка — опишите жанр и структуру секций с учётом атмосферы уровня и требований к зацикливанию, чтобы создать оригинальные BGM-материалы, встраиваемые в игру.
- Бренды и создатели контента для соцсетей: тематическая музыка — на основе описания тональности бренда или референсных изображений создавайте эксклюзивную музыку, подходящую контенту, для рекламных роликов и социальных материалов.
- Разработчики инструментов: интеграция возможностей генерации музыки — через единый интерфейс HiAPI.ai подключите генерацию музыки по тексту к собственным креативным инструментам или контент-платформам, предоставляя конечным пользователям возможности генерации.
Ограничения и рекомендации по выбору
Максимальная длительность одной генерации — около 3 минут; произведения большей длины нужно генерировать по частям и затем склеивать, а для достижения финального результата требуется ручная постобработка. Выводится только аудио, без возможностей изображения или видео. Чем конкретнее описание в промпте, тем выше шанс получить пригодный результат; расплывчатые описания могут потребовать нескольких итераций. seed повышает воспроизводимость, но не обеспечивает строгой детерминированности. Если нужны только короткие фрагменты или более лёгкие материалы для прослушивания, можно рассмотреть модели той же серии, например Lyria 3.
Создать задачу генерации
https://api.hiapi.ai/v1/tasks Заголовки
AuthorizationstringОбязательноAPI-ключ аккаунта. Обязателен в каждом запросе. Пример: Bearer YOUR_HIAPI_API_KEY. Получить API-ключ
Content-TypestringНеобязательноТело запроса всегда разбирается как JSON; при отправке принимается только application/json (charset опционален) — любое иное значение возвращает 415. Пример: application/json.
Idempotency-KeystringНеобязательноКлюч идемпотентности, до 255 байт. Повторные запросы с тем же ключом того же аккаунта создают задачу лишь один раз; реплеи возвращают исходный taskId.
При сетевых таймаутах или автоповторах клиента один и тот же ключ создаёт задачу только один раз, без двойного списания (область = аккаунт API-ключа). Рекомендуется бизнес-уникальный идентификатор (напр. "order-42"); реплеи возвращают исходный taskId, ключ истекает через 24 часа после первого запроса. Полная матрица сценариев — во введении единого асинхронного API.
Тело запроса
modelstringОбязательноТекущее фиксированное значение: lyria-3-pro
routestringНеобязательноТекущее фиксированное значение: default
inputobjectОбязательно
Объект бизнес-параметров для lyria-3-pro и маршрута default — см. таблицу параметров ниже.
seedintegerНеобязательноmin 0Необязательное случайное зерно для воспроизводимых результатов генерации; одинаковое зерно не гарантирует полностью детерминированный вывод.
promptstringОбязательноminLength 1Текстовый промпт для описания музыкального стиля, инструментов, настроения, темпа, текста песни и структуры композиции; можно добавлять временные метки вида [0:00 - 0:30], чтобы задавать развитие аранжировки.
image_urlsarrayНеобязательноminItems 1maxItems 10Необязательный массив вдохновляющих изображений для задания настроения, темы и аранжировки музыки; эти изображения не являются визуальными кадрами или исходным материалом аудиовыхода.
Array [ string ]
callbackobjectНеобязательно
Настройка уведомления о терминальном состоянии. Если не задана — обратных вызовов нет, опрашивайте задачу сами.
Укажите callback.url при создании, и HiAPI отправит POST вашему сервису в терминальном состоянии — опрос не нужен. Тело callback повторяет структуру деталей задачи; проверка подписи, повторы и идемпотентность описаны во введении единого асинхронного API.
urlstringОбязательноОбязательна при наличии callback. В терминальном состоянии на этот URL отправляется POST; это должна быть корректная http(s)-ссылка.
whenstringНеобязательноПо умолчанию: "final"Сейчас поддерживается только final — уведомление и при success, и при fail.
finalstoragestringНеобязательноПо умолчанию: "temp"Уровень хранения артефактов: temp (по умолчанию, ~7 дней) или persistent (долгосрочно, оплата по объёму). При нехватке баланса или превышении лимита — тихое понижение до temp; фактический уровень виден в ответе деталей задачи.
temppersistentПримеры запроса
# Отправляет асинхронную задачу; сразу возвращает taskId (не ждёт генерации)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "lyria-3-pro",
"input": {
"prompt": "…"
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "lyria-3-pro",
input: {
"prompt": "…"
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "lyria-3-pro",
"input": {
"prompt": "…"
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Получить детали задачи
https://api.hiapi.ai/v1/tasks/:id Поля ответа
taskIdstringОбязательноИдентификатор задачи, всегда с префиксом tk-hiapi-.
modelstringОбязательноПолное разрешённое имя модели. Задачи, отправленные с параметром route, возвращают base@route (напр. gpt-image-2/text-to-image@ext); иначе совпадает с переданным именем.
routestringНеобязательноПрисутствует только при явном параметре route; повторяет переданное значение.
statusstringОбязательноСтатус задачи.
queued В очереди, ещё не начата.
handling Обрабатывается.
archiving Обработка завершена, готовятся артефакты.
success Терминальное: завершено, артефакты доступны (возвращается output).
fail Терминальное: ошибка (возвращается error).
После отправки следите за status: success и fail — терминальные, остальные нет. Опрашивайте каждые 1–3 с до терминального состояния. При успехе скачайте артефакты из output[].url и перенесите до expireAt; для длительного хранения укажите storage: "persistent" при создании.
creatednumberОбязательноВремя создания задачи (Unix-секунды).
completednumberОбязательноUnix-секунды терминального состояния; до этого — 0.
outputarrayНеобязательно
Только при status == success. Список артефактов — всегда массив; одна задача может вернуть несколько type сразу (напр. video + first_frame).
Array [ object ]
Элементы массива
urlstringОбязательноURL артефакта, доступен для скачивания напрямую.
typestringОбязательноТекущие возможные значения: video, image, audio, first_frame, last_frame, thumbnail; список может расширяться.
expireAtnumberОбязательноUnix-секунды доступности артефакта; скачайте или перенесите до истечения.
errorobjectНеобязательно
Только при status == fail.
codestringОбязательноБизнес-код ошибки.
messagestringОбязательноОписание ошибки.
Примеры ответа
Успех
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} Обработка (не финальное)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Ошибка
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Статьи
Все статьи →-
Руководство
Как вызывать kling-4.0/image-to-video на HiAPI: curl, Python и опрос
-
Руководство
Как использовать kling-4.0/text-to-video через HiAPI API: curl, Python и рабочий пример запроса
Практическое руководство для разработчиков: кинематографичные промпты, синхронный звук, асинхронный опрос и скачивание результатов
-
Сравнительный обзор
hailuo-2.3-fast/image-to-video — горизонтальное сравнение: как выбрать модель «изображение в видео» и что учесть при миграции
-
Руководство
kandinsky-6.0-pro/image-to-video в HiAPI: руководство по curl + Python
Как выполнить рабочий запрос генерации видео из изображения в HiAPI: от загрузки первого кадра до асинхронного опроса и финальной загрузки
-
Сравнительный обзор
Recraft v4.1 Flash 文生图横向对比:开发者选型与迁移指南
用每张 $0.01 的成本与纯文生图能力,判断它是否适合你的图像生成流水线
-
Руководство
Как вызвать hailuo-2.3-fast/image-to-video через HiAPI API: практика с curl и Python
Первый рабочий запрос к быстрому и недорогому уровню генерации видео по изображению — от ID модели до загрузки MP4
-
Руководство
Использование Kandinsky 6.0 Pro для преобразования текста в видео на HiAPI: руководство по curl и Python
Практическая демонстрация с упором на запросы: построение вызова от промпта до видеоклипа, отправка запроса, опрос статуса завершения и скачивание результата
-
Руководство
Как вызывать hailuo-2.3/text-to-video через API HiAPI: curl, Python и рабочие примеры запросов
-
Руководство
Практика генерации изображений по тексту с recraft-v4.1-flash: 5 ценных бизнес-сценариев и ключевые моменты интеграции
Отталкиваясь от стоимости $0.01 за изображение, спланируйте внедрение генерации изображений в реальные бизнес-процессы
Похожие модели
Все модели →Тот же тип
-
MiniMax Music 2.6 MiniMax $0.210 /трек -
Qwen Audio 3.0 TTS Alibaba $0.030 /1 000 символов -
MiniMax Music 3 MiniMax $0.0026 /секунду -
MiniMax Music 1.5 MiniMax $0.070 /трек -
Mirelo SFX 2.0 Mirelo AI $0.021 /секунду -
Gemini 3.1 Flash TTS Google -- -
Lyria 3.5 Google $0.090 /трек -
Mureka 9.5 Mureka $0.322 per request -
ElevenLabs ElevenLabs $0.0029 /секунду
Тот же вендор
-
Nano Banana Google $0.021 /изображение -
Veo 3.1 Google $0.290 /секунду -
Imagen 4 Google $0.030 /изображение -
Nano Banana 2 Lite Google $0.033 /изображение -
Gemini 3.1 Flash TTS Google -- -
Veo 3.1 Lite Google $0.060 /секунду -
Lyria 3.5 Google $0.090 /трек -
Gemini Omni 1.1 Flash Google $0.450 /видео -
Nano Banana Pro Google $0.057 /изображение -
Nano Banana 2 Google $0.036 /изображение -
Google Virtual Try-On Google $0.107 /изображение -
Veo 3.1 Fast Google $0.170 /секунду






