Введение
Опишите музыку в prompt: укажите приблизительную длину и нужную аранжировку. Lyria 3.5 возвращает один стереотрек MP3 44,1 кГц с оплатой за трек при любой длительности. В предоставленном тесте акустического фолка запрос на 30 секунд дал 61,6 секунды аудио.
| Характеристика | Значение |
|---|---|
| Ввод | Текст |
| Вывод | Аудио |
| Музыкальная модель | Google DeepMind Lyria 3.5 |
| Принимаемое поле | prompt |
| Получаемый файл | Один трек MP3, стерео 44,1 кГц |
| Замер кодирования | Около 193 кбит/с |
| Управление длиной | Приблизительный ориентир в описании; поля длительности нет |
| Расчётная единица | Один сгенерированный трек любой длины |
Ключевые возможности и особенности
Соберите музыкальные решения в одном задании
Жанр, настроение, инструменты, темп, структура и желаемая длина задаются текстом. Для подкаста укажите сдержанную аранжировку и вступительный мотив; для видеомонтажа — нарастание и спад энергии. Так вы получите конкретные ориентиры для прослушивания готового трека.
Планируйте обрезку после прослушивания
Наш запрос инструментального акустического фолка на 30 секунд при 100 BPM дал MP3 длиной 61,6 секунды примерно за 30 секунд. Этот замер помогает предусмотреть прослушивание и обрезку. Он не подтверждает точного управления длиной или типичного времени обработки разных жанров.
Добавьте стереофонический MP3 в проект
Каждая генерация выдаёт один стереотрек MP3 44,1 кГц; в тесте измерено около 193 кбит/с. Сверьте начало, середину и конец с творческим заданием. Если в подкасте или рекламе есть диктор, прослушайте музыку под его речью до утверждения микса.
Рассчитайте варианты по количеству композиций
Единица оплаты — сгенерированный трек; его длина не увеличивает расчёт. Посмотрите указанную ставку и определите, какие варианты задания стоит отправить. Просьба о коротком фрагменте меняет музыкальную задачу, сохраняя единицу оплаты.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Опишите жанр, настроение, инструменты, темп и развитие от вступления к концовке. При необходимости добавьте «instrumental». Не менее 1 символов · Не более 5000 символов |
image_url | Нет | Не поддерживается этим интерфейсом; не включайте |
Стоимость
$0.12 / композиция
Одно списание за каждую созданную композицию независимо от её длины. Неудачные генерации не оплачиваются; ставка за трек указана на этой странице.
Сценарии использования
Музыкальный фон для видео
Для монтажа похода запросите воодушевляющий инструментальный акустический фолк в темпе 100 BPM с гитарным перебором, лёгкой перкуссией и мягкой концовкой. Полученный MP3 можно примерить к кадрам и обрезать по монтажу.
Заставка для подкаста
Для еженедельного научного подкаста опишите любопытное настроение электронной инструментальной музыки: 90 BPM, округлые синтезаторные звуки, сдержанные ударные и короткий вступительный мотив. Редактор получит материал для заставки под приветствие ведущего.
Музыка для игрового цикла
Для уровня головоломки задайте спокойный эмбиент на 80 BPM с мягкой маримбой, протяжёнными пэдами и повторяющимся разделом. Скачайте MP3, выберите подходящий отрезок и проверьте стык цикла или оформите кроссфейд в аудиоредакторе.
Подложка для рекламы
Для демонстрации товаров для дома запросите светлую инструментальную поп-музыку в темпе 110 BPM с приглушённой гитарой, лёгким басом и редкой перкуссией. Рассмотрите MP3 как вариант подложки и убедитесь, что он оставляет место закадровой речи.
Эскиз настроения до записи музыки
Для тихой ночной сцены опишите задумчивую фортепианную композицию на 70 BPM: редкие ноты в начале и тёплые струнные ближе к концу. Трек поможет обсудить музыкальное направление до создания финальной партитуры.
Руководство по промптам и практические советы
Сформулируйте музыкальное задание
Укажите жанр, настроение, конкретные инструменты, темп и развитие от начала до конца. Желаемую длину задайте как ориентир; добавьте «instrumental», если нужна инструментальная композиция.
Отправьте запрос генерации
Выполните POST на https://api.spicyapi.ai/api/v1/jobs/createTask с Bearer-авторизацией и JSON {"model":"google/lyria-3.5/text-to-audio","input":{"prompt":"Calm acoustic folk instrumental, 100 BPM, picked guitar, soft percussion, gentle ending; aim for 30 seconds."}}.
Заберите завершённый трек
Сохраните data.taskId, затем вызывайте GET /api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID с тем же API-ключом, которым создана задача. Когда data.state станет succeeded, получите MP3 по data.output.assets[0].url.
Проверьте длину в монтаже
Прослушайте аранжировку целиком и измерьте фактическую длительность перед размещением на временной шкале. Измените описание для другого музыкального направления или обрежьте файл, если нужна точная точка завершения.
Lyria 3.5 API: музыка из текста
Lyria 3.5 от Google DeepMind создаёт композицию по письменному заданию и выдаёт один MP3 через этот интерфейс преобразования текста в аудио. Опишите жанр, настроение, инструменты, темп, структуру и желаемую длину в prompt, чтобы направить сочинение.
В анонсе Lyria 3.5 Google сообщает об улучшениях музыкальности, работы с текстом песен и выразительности вокала. Наш тест акустического фолка ниже измеряет длительность и время обработки.
Отправка музыкального задания
Укажите google/lyria-3.5/text-to-audio, поместив музыкальное описание в input.prompt. Это иллюстративное тело запроса, отличающееся от задания измеренного теста:
{
"model": "google/lyria-3.5/text-to-audio",
"input": {
"prompt": "Gentle acoustic folk instrumental, 100 BPM, picked guitar, warm bass and brushed percussion. Begin with guitar, add a restrained rhythm section, then close softly. Aim for 30 seconds."
}
}
- Отправьте тело в
POST https://api.spicyapi.ai/api/v1/jobs/createTaskсAuthorization: Bearer YOUR_API_KEYиContent-Type: application/json. - Сохраните
data.taskIdиз ответа о приёме. - Вызывайте
GET /api/v1/jobs/recordInfo?taskId=YOUR_TASK_IDс API-ключом создания до конечного состояния задачи. - При
succeededскачайтеdata.output.assets[0].url.
Чтение результата задачи
Принятая задача получает идентификатор ещё до появления музыки. Эти сокращённые ответы содержат условные идентификаторы и пример адреса файла:
{
"code": 200,
"data": {
"taskId": "job_YOUR_TASK_ID",
"state": "queued"
}
}
{
"code": 200,
"data": {
"taskId": "job_YOUR_TASK_ID",
"state": "succeeded",
"output": {
"assets": [
{"url": "https://example.com/your-track.mp3"}
]
}
}
}
Полная структура описана в документации API задач. Проверьте конечное состояние, прежде чем считать запись готовым к использованию треком.
Параметры и музыкальные ориентиры
Все доступные музыкальные настройки передаются в prompt. Темп и длина задаются словами внутри него, отдельных числовых полей нет.
| Поле или указание | Как использовать |
|---|---|
prompt | Передайте музыкальное задание текстом. |
| Жанр и настроение | Назовите стиль и ощущение, например задумчивый акустический фолк. |
| Инструменты | Укажите ведущий инструмент и сопровождающие партии. |
| Темп | Впишите BPM или описание скорости. |
| Структура | Опишите вступление, развитие и завершение. |
| Желаемая длина | Укажите пожелание по длине; проверьте фактическую длительность. |
| Неподдерживаемые поля | Исключите image_url, duration, seed и настройки выходного формата. |
Как подогнать музыку к проекту
Конкретное задание на аранжировку даёт ясные критерии прослушивания. Для рекламной подложки запросите сдержанный состав и слушайте с настоящей дикторской записью; для игровой сцены — повторяющийся фрагмент с последующей обработкой стыка цикла.
- Укажите «instrumental», если нужна музыка без вокальной партии.
- Выберите ведущий инструмент и небольшой сопровождающий ансамбль, чтобы обозначить желаемое звучание.
- Опишите изменения энергии вместо набора несвязанных слов о настроении.
- Между дублями меняйте одну часть задания и сравнивайте соответствующую музыкальную деталь.
- Храните утверждённый MP3 вместе с описанием, чтобы выбранный вариант оставался доступен.
Что показал тест акустического фолка
Наш тест инструментального акустического фолка дал 61,6 секунды музыки при запросе на 30 секунд и 100 BPM. Генерация заняла примерно 30 секунд; получен один стереофонический MP3 44,1 кГц с битрейтом около 193 кбит/с.
| Условие или измерение | Зафиксированное значение |
|---|---|
| Задание | Нейтральный инструментальный акустический фолк |
| Заданный темп | 100 BPM |
| Запрошенная длина | 30 секунд |
| Фактическая длительность | 61,6 секунды |
| Время обработки | Около 30 секунд |
| Аудио | MP3, стерео 44,1 кГц, около 193 кбит/с |
Этот единичный результат показывает приблизительное следование длине, не устанавливая типичную задержку или качество разных стилей. Прослушайте весь файл и изменения аранжировки, затем измерьте и обрежьте его для точного видеомонтажа или начала подкаста.
Оплата за созданный трек
Расчёт ведётся за трек независимо от его длительности. Для бюджета вариантов смотрите ставку на странице: просьба о более коротком фрагменте не меняет единицу оплаты. За неудачную генерацию плата за трек не взимается.
Ограничения и диагностика
Если музыка выходит за нужные рамки времени, потребуется монтаж: отдельной настройки длительности нет. При ошибке проверьте, что input содержит поддерживаемое поле prompt, и изучите ответ с ошибкой перед отправкой исправленного задания.
Google сообщает, что музыкальные фильтры блокируют запросы голосов конкретных артистов и защищённых авторским правом текстов песен. Описывайте музыкальные качества, используйте разрешённые тексты и голоса и не выдавайте результат за реального человека. В карточке модели Google также описывает водяные знаки SynthID.
Соседние модели для другого процесса
Выберите этот интерфейс для скачиваемого трека с описанными словами аранжировкой и приблизительной длиной. По ссылкам на документацию Google можно изучить Clip для коротких фрагментов и RealTime для потока.
| Потребность | Вариант для рассмотрения |
|---|---|
| MP3 по описанию для монтажной шкалы | Lyria 3.5 text-to-audio |
| Музыкальный фрагмент фиксированной длины 30 секунд | По данным Google, Lyria 3 Clip создаёт клипы на 30 секунд. |
| Инструментальная музыка с управлением во время воспроизведения | Google описывает Lyria RealTime как модель интерактивного потока. |
| Точный отрезок или подготовленный цикл | Обрежьте скачанный трек или сделайте кроссфейд в аудиоредакторе. |
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "google/lyria-3.5/text-to-audio",
"input": {
"prompt": "Calm ambient pads with a slow rising motif"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.
