Создаёт музыкальные треки по текстовому описанию и референс-изображению, помогая задать жанр, настроение, структуру и звучание. Цена - 12 рублей за трек.
Общая документация Public API · API-ключ можно создать в настройках аккаунта
Lyria 3 Pro пишет законченный музыкальный трек по текстовому описанию: с вокалом или без, в любом жанре, с заданным темпом, инструментами и структурой. Дополнительно можно передать картинку - нейросеть возьмёт из неё настроение. Один вызов - один трек за фиксированные 12 ₽, поэтому инструмент удобен для подбора музыки к роликам, рекламы, подкастов и игр.
Каждый вызов создаёт асинхронную операцию: вы получаете id, а результат забираете отдельным запросом статуса.
POST /api/v1/operationsAuthorization: Bearer brth_...id и стартовый статус queued.{
"tool": "lyria-3-pro",
"input": {
"...": "..."
}
}
tool - slug нейросети, здесь всегда "lyria-3-pro".input - параметры конкретного запуска.input, без дополнительного вложенного объекта input.| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
prompt | string | Да | Описание трека, от 10 до 4000 символов: жанр, настроение, темп, инструменты, структура, вокал и язык. |
image_url | string (url) | Нет | Референс-изображение для настроения. Только http/https, форматы .jpg, .jpeg, .png, .webp. |
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "lyria-3-pro",
"input": {
"prompt": "Энергичный синти-поп 80-х с ярким вокалом, драм-машина, аналоговые синтезаторы, припев с хуком, 120 BPM"
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"tool": "lyria-3-pro",
"input": {
"prompt": "Энергичный синти-поп 80-х с ярким вокалом, драм-машина, аналоговые синтезаторы, припев с хуком, 120 BPM"
}
}),
})
const data = await response.json()
import requests
response = requests.post(
'https://bratuha.ru/api/v1/operations',
headers={
'Authorization': 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
json={
"tool": "lyria-3-pro",
"input": {
"prompt": "Энергичный синти-поп 80-х с ярким вокалом, драм-машина, аналоговые синтезаторы, припев с хуком, 120 BPM"
}
},
timeout=30,
)
print(response.status_code)
print(response.json())
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "lyria-3-pro",
"input": {
"prompt": "Спокойная акустическая композиция под настроение этой фотографии: гитара, лёгкие струнные, без вокала",
"image_url": "https://cdn.example.com/source-image-1.jpg"
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"tool": "lyria-3-pro",
"input": {
"prompt": "Спокойная акустическая композиция под настроение этой фотографии: гитара, лёгкие струнные, без вокала",
"image_url": "https://cdn.example.com/source-image-1.jpg"
}
}),
})
const data = await response.json()
import requests
response = requests.post(
'https://bratuha.ru/api/v1/operations',
headers={
'Authorization': 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
json={
"tool": "lyria-3-pro",
"input": {
"prompt": "Спокойная акустическая композиция под настроение этой фотографии: гитара, лёгкие струнные, без вокала",
"image_url": "https://cdn.example.com/source-image-1.jpg"
}
},
timeout=30,
)
print(response.status_code)
print(response.json())
{
"id": "op_uuid-123",
"status": "queued",
"tool": "lyria-3-pro",
"cost": 12,
"balance_after": 495,
"created_at": "2026-09-17T12:00:00Z"
}
{
"id": "op_uuid-123",
"status": "completed",
"tool": "lyria-3-pro",
"cost": 12,
"created_at": "2026-09-17T12:00:00Z",
"completed_at": "2026-09-17T12:01:20Z",
"result": {
"type": "audio",
"urls": [
"https://storage.bratuha.ru/results/lyria-3-pro/audio-1.mp3"
]
},
"error_message": null
}
{
"id": "op_uuid-123",
"status": "failed",
"tool": "lyria-3-pro",
"cost": 12,
"created_at": "2026-09-17T12:00:00Z",
"completed_at": "2026-09-17T12:00:20Z",
"result": null,
"error_message": "Произошла ошибка, сервис временно недоступен. Попробуйте повторить запрос позже."
}
После создания операции сохраните id и проверяйте её статус запросом:
GET /api/v1/operations/{id}
curl -H "Authorization: Bearer brth_ваш_ключ" \
https://bratuha.ru/api/v1/operations/op_uuid-123
const response = await fetch(
'https://bratuha.ru/api/v1/operations/op_uuid-123',
{
headers: {
Authorization: 'Bearer brth_ваш_ключ',
},
}
)
const data = await response.json()
Пока операция выполняется, status будет queued или processing. Опрашивайте статус раз в 5-10 секунд.
После успешного завершения result содержит один трек:
{
"type": "audio",
"urls": [
"https://storage.bratuha.ru/results/lyria-3-pro/audio-1.mp3"
]
}
type всегда равен "audio".urls содержит одну ссылку на MP3.cost ответа. Если операция завершилась с ошибкой, деньги возвращаются на баланс автоматически.POST /api/v1/operations не идемпотентен: каждый повторный запрос создаёт новую операцию и списывает деньги.queued проверяйте статус по id.http/https ссылки, без localhost и приватных адресов. HEIC/HEIF принимаются только при загрузке через форму сайта, по URL в API - нет.prompt результат будет случайным.