Lyria 3.5 API

Lyria 3.5 API

Lyria 3.5 - музыкальная модель Google. Она делает законченный трек около 3 минут: песню с вокалом или инструментал. Подходит для фоновой музыки к видео и подкастам, демо песни, поздравлений и джинглов. Режим выбирается полем generation_type:

• describe - трек по описанию в describe_prompt: модель сама сочиняет музыку и, если в описании есть вокал, слова;
• lyrics - песня на ваш текст из lyrics_text, стиль можно описать в lyrics_style.

В обоих режимах можно задать название трека и темп в ударах в минуту. Каждый вызов создаёт асинхронную операцию: в ответ сразу приходит id, а готовый трек вы забираете отдельным запросом статуса.

Создание операции

• Endpoint: POST /api/v1/operations
• Авторизация: Authorization: Bearer brth_...
• Запрос создаёт операцию и сразу возвращает id и стартовый статус queued.
• Выполнение асинхронное: трек обычно готов примерно за минуту.

Сценарии, которые поддерживает модель:

1. generation_type: "describe" - трек по описанию.
2. generation_type: "lyrics" - песня на свой текст.

Тело запроса

{
  "tool": "lyria-3-5",
  "input": {
    "...": "..."
  }
}

• tool - slug нейросети, здесь всегда "lyria-3-5".
• input - параметры конкретного запуска.
• Все поля передаются напрямую внутри input, без дополнительного вложенного объекта input. Набор полей зависит от режима.

Параметры

Общие

Трек по описанию (describe)

Песня на свой текст (lyrics)

Примеры запросов

Сценарий 1. Трек по описанию

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "lyria-3-5",
    "input": {
      "generation_type": "describe",
      "describe_prompt": "Лёгкий инструментальный лоу-фай для учёбы: тёплое электропиано, мягкие барабаны, виниловый треск. Без вокала.",
      "title": "Вечер за конспектом",
      "use_bpm": true,
      "bpm": 80
    }
  }'

JavaScript / TypeScript

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-5',
    input: {
      generation_type: 'describe',
      describe_prompt:
        'Лёгкий инструментальный лоу-фай для учёбы: тёплое электропиано, мягкие барабаны, виниловый треск. Без вокала.',
      title: 'Вечер за конспектом',
      use_bpm: true,
      bpm: 80,
    },
  }),
})

const data = await response.json()

Python

import requests

response = requests.post(
    'https://bratuha.ru/api/v1/operations',
    headers={
        'Authorization': 'Bearer brth_ваш_ключ',
        'Content-Type': 'application/json',
    },
    json={
        'tool': 'lyria-3-5',
        'input': {
            'generation_type': 'describe',
            'describe_prompt': 'Лёгкий инструментальный лоу-фай для учёбы: тёплое электропиано, мягкие барабаны, виниловый треск. Без вокала.',
            'title': 'Вечер за конспектом',
            'use_bpm': True,
            'bpm': 80,
        },
    },
    timeout=30,
)

print(response.status_code)
print(response.json())

Сценарий 2. Песня на свой текст

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "lyria-3-5",
    "input": {
      "generation_type": "lyrics",
      "lyrics_text": "[Verse]\nГород засыпает, фонари горят,\nЯ иду по улице, мысли не молчат.\n[Chorus]\nЭто наш вечер, только ты и я,\nПусть весь мир подождёт до утра.",
      "lyrics_style": "русская поп-баллада, фортепиано, струнные, тёплый женский вокал",
      "title": "Наш вечер"
    }
  }'

JavaScript / TypeScript

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-5',
    input: {
      generation_type: 'lyrics',
      lyrics_text: [
        '[Verse]',
        'Город засыпает, фонари горят,',
        'Я иду по улице, мысли не молчат.',
        '[Chorus]',
        'Это наш вечер, только ты и я,',
        'Пусть весь мир подождёт до утра.',
      ].join('\n'),
      lyrics_style: 'русская поп-баллада, фортепиано, струнные, тёплый женский вокал',
      title: 'Наш вечер',
    },
  }),
})

const data = await response.json()

Python

import requests

lyrics = """[Verse]
Город засыпает, фонари горят,
Я иду по улице, мысли не молчат.
[Chorus]
Это наш вечер, только ты и я,
Пусть весь мир подождёт до утра."""

response = requests.post(
    'https://bratuha.ru/api/v1/operations',
    headers={
        'Authorization': 'Bearer brth_ваш_ключ',
        'Content-Type': 'application/json',
    },
    json={
        'tool': 'lyria-3-5',
        'input': {
            'generation_type': 'lyrics',
            'lyrics_text': lyrics,
            'lyrics_style': 'русская поп-баллада, фортепиано, струнные, тёплый женский вокал',
            'title': 'Наш вечер',
        },
    },
    timeout=30,
)

print(response.status_code)
print(response.json())

Примеры ответов

Ответ после создания

{
  "id": "op_uuid-123",
  "status": "queued",
  "tool": "lyria-3-5",
  "cost": 10,
  "balance_after": 490,
  "created_at": "2026-10-02T12:00:00Z"
}

Ответ после завершения

{
  "id": "op_uuid-123",
  "status": "completed",
  "tool": "lyria-3-5",
  "cost": 10,
  "created_at": "2026-10-02T12:00:00Z",
  "completed_at": "2026-10-02T12:00:55Z",
  "result": {
    "type": "audio",
    "urls": [
      "https://storage.bratuha.ru/results/lyria-3-5/track.m4a"
    ],
    "files": [
      { "url": "https://storage.bratuha.ru/results/lyria-3-5/track.m4a", "name": "result" }
    ]
  },
  "error_message": null
}

Ответ с ошибкой

{
  "id": "op_uuid-123",
  "status": "failed",
  "tool": "lyria-3-5",
  "cost": 10,
  "created_at": "2026-10-02T12:00:00Z",
  "completed_at": "2026-10-02T12:00:40Z",
  "result": null,
  "error_message": "Произошла ошибка, нейросеть временно недоступна."
}

Проверка статуса

После создания операции сохраните её id и проверяйте статус по нему:

GET /api/v1/operations/{id}

cURL

curl -H "Authorization: Bearer brth_ваш_ключ" \
  https://bratuha.ru/api/v1/operations/op_uuid-123

JavaScript / TypeScript

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. Опрашивайте статус раз в 10-15 секунд.

Формат результата

После успешного завершения result содержит аудиофайл - обычно один, иногда два варианта трека:

{
  "type": "audio",
  "urls": [
    "https://storage.bratuha.ru/results/lyria-3-5/track.m4a"
  ],
  "files": [
    { "url": "https://storage.bratuha.ru/results/lyria-3-5/track.m4a", "name": "result" }
  ]
}

• type всегда равен "audio".
• urls содержит ссылку на файл .m4a (AAC, стерео, 48 кГц), который играет в браузерах, на телефонах и в видеоредакторах. Иногда в массиве две ссылки - два варианта одного трека, оба входят в цену.
• files дублирует те же ссылки с именем файла.
• Длительность трека - около 3 минут, задать её нельзя.

Ценообразование

• Любой трек стоит 10 ₽ за запуск.
• Цена не зависит от режима, длины текста, названия и темпа.
• Сумма списывается при создании операции и видна в поле cost ответа. Если операция завершилась с ошибкой, деньги возвращаются на баланс автоматически.

Ограничения и практические заметки

• POST /api/v1/operations не идемпотентен: каждый повторный запрос создаёт новую операцию и списывает деньги.
• Операция выполняется асинхронно: после queued проверяйте статус по id.
• Файлы на вход модель не принимает: всё задаётся текстом, поэтому ссылки передавать не нужно.
• В режиме describe обязательно поле describe_prompt, в режиме lyrics - lyrics_text. Без них запрос получит validation_error.
• Поля другого режима сервер игнорирует: например, lyrics_style в запросе с describe ни на что не влияет.
• bpm учитывается только вместе с use_bpm: true.
• Обычно один запуск даёт один трек. Чтобы выбрать лучший вариант, запустите одно и то же описание несколько раз: каждый раз модель сочиняет заново.
• В режиме lyrics модель может дописать свои строки и повторить припев, чтобы трек получился полной длины. Если нужен строго ваш текст, дайте его целиком: два-три куплета, припев и бридж.