Создаёт песни по описанию или вашему тексту, инструменталы, каверы и треки с голосом или стилем образца, продлевает треки и заменяет участки. Цена — 10 ₽ за трек, два варианта в модели v2 — 15 ₽.
Общая документация Public API · API-ключ можно создать в настройках аккаунта
Treblo пишет песни и музыку: по описанию, по вашему тексту, без слов, по образцу чужого трека. Через API доступны все режимы формы на сайте - можно создать трек, продлить его, сделать кавер, перенести стиль или голос с образца и заменить участок готовой песни.
Что важно понимать заранее:
treblo_mode, от него зависит набор остальных полей;prompt или точнее - списком стилей в styles (жанры, эпохи, инструменты, голос, настроение);v2 и в замене участка.Каждый вызов создаёт асинхронную операцию. Трек готовится от 30 секунд до 4-5 минут, поэтому после создания нужно проверять статус по id.
POST /api/v1/operationsAuthorization: Bearer brth_...id и стартовый статус queued.Режимы (treblo_mode):
create - новый трек по описанию, своему тексту или без слов;extend - продолжение готового трека;cover - кавер: та же мелодия в новом исполнении;style - новая песня в звучании образца (своя мелодия и текст);voice - новая песня голосом певца из образца;inpaint - замена одного участка готового трека.{
"tool": "treblo",
"input": {
"treblo_mode": "create",
"...": "..."
}
}
tool - slug нейросети, всегда "treblo".input - параметры запуска. Все поля передаются прямо внутри этого объекта, без дополнительной вложенности.| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
treblo_mode | enum | Да | Режим: create, extend, cover, style, voice, inpaint. |
treblo_model | enum | Только create, extend | Модель: v3 - новая, трек до 4:45 и выбор длительности; v2 - прежняя, быстрее, до двух вариантов, темп и seed. |
source_audio | string (URL) | extend, inpaint | Ссылка на исходный трек. Форматы MP3, WAV, FLAC, M4A, AAC, OGG, AIFF, AMR, до 40 МБ. |
reference_audio | string (URL) | cover, style, voice | Ссылка на образец, те же форматы, от 12 секунд до 20 минут, до 40 МБ. |
instrumental | enum | create, extend, cover, style | "false" - с вокалом, "true" - инструментал. Значение передаётся строкой. |
prompt | string | Все режимы, кроме inpaint | Описание: жанр, настроение, инструменты, голос, о чём песня. От 3 до 3000 символов. В extend - каким должно быть продолжение. |
use_lyrics | boolean | Нет | true, если передаёте свой текст в lyrics. Не работает с instrumental: "true". |
lyrics | string | Если use_lyrics: true | Текст песни, от 3 до 20000 символов. Части отмечайте в квадратных скобках на отдельной строке: [Verse], [Chorus], [Bridge]. Чем больше текста, тем длиннее трек. Для кавера с прежними словами передайте текст исходной песни. |
styles | string[] | Нет | Для create с v3, extend с v3, cover, style, voice: точные стили, например ["русский рок", "80-е", "мужской вокал"]. Можно по-русски или по-английски (russian rock, 1980s, male vocalist), понимаются популярные стили, неизвестные слова не учитываются. Если передан свой текст (use_lyrics: true), стили заменяют описание из prompt. |
length | enum | Нет | Длительность для create с v3, cover, style, voice: auto, 30-60, 60-90, 90-120, 120-180, 180-240, 240-300 (секунды). Это пожелание - трек может выйти немного короче или длиннее, со своим текстом длину задаёт в основном объём текста. |
variants | enum | Нет | Для v2 и inpaint: "1" - один трек, "2" - два варианта (дороже на 5 ₽). |
output_format | enum | Да | Формат файла: mp3 (320 кбит/с), wav, flac. |
extend_side | enum | extend с v2 | right - продлить в конец, left - в начало. |
extend_duration | number | Нет | extend с v2: длина продолжения, от 5 до 85 секунд. |
crop_duration | number | Нет | extend: сколько секунд срезать с продлеваемой стороны перед продолжением, от 0 до 60. Удобно, чтобы убрать затухание в конце. |
reference_scale | number | Нет | cover, style: близость к образцу, от 1 до 5. Чем выше, тем точнее повтор, но звучание может стать менее естественным. |
voice_scale | number | Нет | voice: близость голоса к образцу, от 1 до 7. |
voice_source | enum | Нет | voice: что в образце - song (песня с музыкой, голос будет отделён от инструментов) или voice (запись одного голоса). |
use_fragment | boolean | Нет | cover, style, voice: true, чтобы взять фрагмент образца. Без него берутся первые 90 секунд (для голоса - 75). |
fragment_start, fragment_end | number | Если use_fragment: true | Начало и конец фрагмента в секундах. Длина: кавер 12-165 с, стиль 12-270 с, голос 10-75 с. |
section_start, section_end | number | inpaint | Начало и конец заменяемого участка в секундах, конец позже начала. |
inpaint_vocal | enum | inpaint | Вокал на участке: female, male, none (без вокала). |
inpaint_style | enum | inpaint | Стиль участка, близкий к исходному треку: pop, russian pop, dance pop, synthpop, indie pop, rock, russian rock, alternative rock, hard rock, metal, punk, hip hop, rap, russian rap, trap, electronic, house, techno, lo-fi, ambient, jazz, blues, soul, r&b, funk, disco, classical, folk, russian folk, country, reggae, latin, chanson, soviet estrada, ballad, acoustic, singer-songwriter, children, christmas. |
inpaint_lyrics | string | inpaint, если вокал не none | Строки, которые прозвучат на месте участка, от 2 до 3000 символов. |
selection_crop | boolean | Нет | inpaint: true - вернуть только новый участок, без остального трека. |
use_advanced | boolean | Нет | true, чтобы применить дополнительные параметры ниже. |
follow | enum | Нет | Для v3-режимов: чему следовать точнее - style (стилю) или prompt (описанию). |
strength | number | Нет | Для v3-режимов: сила следования, от 1.5 до 3. Выше 3 качество падает. |
negative_styles | string[] | Нет | Для v3-режимов: чего не должно быть в треке - жанры, инструменты, настроение, например ["рэп", "электрогитара", "барабаны"]. Можно по-русски или по-английски, понимаются популярные стили, неизвестные слова не учитываются. Не больше 64. |
negative_strength | number | Нет | Насколько строго избегать negative_styles, от 1 до 5. |
context_seconds | number | Нет | extend с v3: сколько последних секунд трека учитывать, от 10 до 280. Учтённая часть и продолжение вместе - не больше 4:45. |
v2_prompt_strength | number | Нет | Для v2 и inpaint: сила следования стилю и тексту, от 1.4 до 3.1. |
balance_strength | number | Нет | Для v2 и inpaint: от 0 до 1, больше - естественнее вокал, меньше - чётче инструменты. |
bpm | number | Нет | create с v2: темп от 40 до 300. Без значения темп выбирает нейросеть. |
seed | number | Нет | Для v2 и inpaint: одинаковые seed, стиль и текст дают одинаковый трек. |
Дополнительные параметры (follow и ниже) учитываются только вместе с use_advanced: true.
Текст и аранжировку нейросеть придумает сама, стили задают звучание точнее.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "treblo",
"input": {
"treblo_mode": "create",
"treblo_model": "v3",
"instrumental": "false",
"prompt": "Лёгкая поп-песня на русском о том, как друзья едут ночью к морю. Женский вокал, тёплое летнее настроение",
"styles": ["русская поп-музыка", "синти-поп", "женский вокал"],
"length": "120-180",
"output_format": "mp3"
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'treblo',
input: {
treblo_mode: 'create',
treblo_model: 'v3',
instrumental: 'false',
prompt: 'Лёгкая поп-песня на русском о том, как друзья едут ночью к морю. Женский вокал, тёплое летнее настроение',
styles: ['русская поп-музыка', 'синти-поп', 'женский вокал'],
length: '120-180',
output_format: 'mp3',
},
}),
})
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': 'treblo',
'input': {
'treblo_mode': 'create',
'treblo_model': 'v3',
'instrumental': 'false',
'prompt': 'Лёгкая поп-песня на русском о том, как друзья едут ночью к морю. Женский вокал, тёплое летнее настроение',
'styles': ['русская поп-музыка', 'синти-поп', 'женский вокал'],
'length': '120-180',
'output_format': 'mp3',
},
},
timeout=30,
)
print(response.json())
Описание задаёт звучание, текст поётся как есть, рэп и электрогитара исключены.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "treblo",
"input": {
"treblo_mode": "create",
"treblo_model": "v3",
"instrumental": "false",
"prompt": "Русский рок-баллада, мужской вокал, акустика и струнные",
"use_lyrics": true,
"lyrics": "[Verse]\nНочь опустилась на старый вокзал\nЯ никому ничего не сказал\n\n[Chorus]\nПоезд уходит, а я остаюсь\nВ городе этом я больше не злюсь",
"output_format": "wav",
"use_advanced": true,
"follow": "prompt",
"strength": 2.2,
"negative_styles": ["рэп", "электрогитара"],
"negative_strength": 3
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'treblo',
input: {
treblo_mode: 'create',
treblo_model: 'v3',
instrumental: 'false',
prompt: 'Русский рок-баллада, мужской вокал, акустика и струнные',
use_lyrics: true,
lyrics: '[Verse]\nНочь опустилась на старый вокзал\nЯ никому ничего не сказал\n\n[Chorus]\nПоезд уходит, а я остаюсь\nВ городе этом я больше не злюсь',
output_format: 'wav',
use_advanced: true,
follow: 'prompt',
strength: 2.2,
negative_styles: ['рэп', 'электрогитара'],
negative_strength: 3,
},
}),
})
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': 'treblo',
'input': {
'treblo_mode': 'create',
'treblo_model': 'v3',
'instrumental': 'false',
'prompt': 'Русский рок-баллада, мужской вокал, акустика и струнные',
'use_lyrics': True,
'lyrics': '[Verse]\nНочь опустилась на старый вокзал\nЯ никому ничего не сказал\n\n[Chorus]\nПоезд уходит, а я остаюсь\nВ городе этом я больше не злюсь',
'output_format': 'wav',
'use_advanced': True,
'follow': 'prompt',
'strength': 2.2,
'negative_styles': ['рэп', 'электрогитара'],
'negative_strength': 3,
},
},
timeout=30,
)
print(response.json())
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "treblo",
"input": {
"treblo_mode": "create",
"treblo_model": "v2",
"instrumental": "false",
"prompt": "Весёлая детская песня про кота, который спит на подоконнике, мужской вокал",
"variants": "2",
"output_format": "mp3",
"use_advanced": true,
"bpm": 120,
"seed": 42
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'treblo',
input: {
treblo_mode: 'create',
treblo_model: 'v2',
instrumental: 'false',
prompt: 'Весёлая детская песня про кота, который спит на подоконнике, мужской вокал',
variants: '2',
output_format: 'mp3',
use_advanced: true,
bpm: 120,
seed: 42,
},
}),
})
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': 'treblo',
'input': {
'treblo_mode': 'create',
'treblo_model': 'v2',
'instrumental': 'false',
'prompt': 'Весёлая детская песня про кота, который спит на подоконнике, мужской вокал',
'variants': '2',
'output_format': 'mp3',
'use_advanced': True,
'bpm': 120,
'seed': 42,
},
},
timeout=30,
)
print(response.json())
Срезаем 8 секунд затухания и дописываем бридж с финальным припевом. В ответе - весь трек вместе с продолжением.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "treblo",
"input": {
"treblo_mode": "extend",
"treblo_model": "v3",
"source_audio": "https://cdn.example.com/source-audio-1.mp3",
"instrumental": "false",
"prompt": "Бридж и громкий финальный припев в том же стиле",
"crop_duration": 8,
"output_format": "mp3"
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'treblo',
input: {
treblo_mode: 'extend',
treblo_model: 'v3',
source_audio: 'https://cdn.example.com/source-audio-1.mp3',
instrumental: 'false',
prompt: 'Бридж и громкий финальный припев в том же стиле',
crop_duration: 8,
output_format: 'mp3',
},
}),
})
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': 'treblo',
'input': {
'treblo_mode': 'extend',
'treblo_model': 'v3',
'source_audio': 'https://cdn.example.com/source-audio-1.mp3',
'instrumental': 'false',
'prompt': 'Бридж и громкий финальный припев в том же стиле',
'crop_duration': 8,
'output_format': 'mp3',
},
},
timeout=30,
)
print(response.json())
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "treblo",
"input": {
"treblo_mode": "cover",
"reference_audio": "https://cdn.example.com/source-audio-2.mp3",
"instrumental": "false",
"prompt": "Акустическая версия, мужской вокал, гитара",
"reference_scale": 2,
"use_fragment": true,
"fragment_start": 10,
"fragment_end": 100,
"output_format": "mp3"
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'treblo',
input: {
treblo_mode: 'cover',
reference_audio: 'https://cdn.example.com/source-audio-2.mp3',
instrumental: 'false',
prompt: 'Акустическая версия, мужской вокал, гитара',
reference_scale: 2,
use_fragment: true,
fragment_start: 10,
fragment_end: 100,
output_format: 'mp3',
},
}),
})
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': 'treblo',
'input': {
'treblo_mode': 'cover',
'reference_audio': 'https://cdn.example.com/source-audio-2.mp3',
'instrumental': 'false',
'prompt': 'Акустическая версия, мужской вокал, гитара',
'reference_scale': 2,
'use_fragment': True,
'fragment_start': 10,
'fragment_end': 100,
'output_format': 'mp3',
},
},
timeout=30,
)
print(response.json())
Режим style устроен так же, только вместо voice_scale и voice_source передаётся reference_scale.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "treblo",
"input": {
"treblo_mode": "voice",
"reference_audio": "https://cdn.example.com/source-audio-3.mp3",
"prompt": "Медленная джазовая баллада на русском о дожде",
"voice_scale": 4,
"voice_source": "song",
"output_format": "mp3"
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'treblo',
input: {
treblo_mode: 'voice',
reference_audio: 'https://cdn.example.com/source-audio-3.mp3',
prompt: 'Медленная джазовая баллада на русском о дожде',
voice_scale: 4,
voice_source: 'song',
output_format: 'mp3',
},
}),
})
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': 'treblo',
'input': {
'treblo_mode': 'voice',
'reference_audio': 'https://cdn.example.com/source-audio-3.mp3',
'prompt': 'Медленная джазовая баллада на русском о дожде',
'voice_scale': 4,
'voice_source': 'song',
'output_format': 'mp3',
},
},
timeout=30,
)
print(response.json())
Строки с 30-й по 45-ю секунду заменяются новыми, два варианта на выбор.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "treblo",
"input": {
"treblo_mode": "inpaint",
"source_audio": "https://cdn.example.com/source-audio-1.mp3",
"section_start": 30,
"section_end": 45,
"inpaint_vocal": "female",
"inpaint_style": "russian pop",
"inpaint_lyrics": "Мы с тобой рисуем мелом на асфальте сны\nИ они растают с первым шагом весны",
"variants": "2",
"output_format": "mp3"
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'treblo',
input: {
treblo_mode: 'inpaint',
source_audio: 'https://cdn.example.com/source-audio-1.mp3',
section_start: 30,
section_end: 45,
inpaint_vocal: 'female',
inpaint_style: 'russian pop',
inpaint_lyrics: 'Мы с тобой рисуем мелом на асфальте сны\nИ они растают с первым шагом весны',
variants: '2',
output_format: 'mp3',
},
}),
})
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': 'treblo',
'input': {
'treblo_mode': 'inpaint',
'source_audio': 'https://cdn.example.com/source-audio-1.mp3',
'section_start': 30,
'section_end': 45,
'inpaint_vocal': 'female',
'inpaint_style': 'russian pop',
'inpaint_lyrics': 'Мы с тобой рисуем мелом на асфальте сны\nИ они растают с первым шагом весны',
'variants': '2',
'output_format': 'mp3',
},
},
timeout=30,
)
print(response.json())
{
"id": "op_uuid-123",
"status": "queued",
"tool": "treblo",
"cost": 10,
"balance_after": 490,
"created_at": "2026-11-15T12:46:26Z"
}
cost - сколько списано за операцию, в рублях.balance_after - баланс после списания.{
"id": "op_uuid-123",
"status": "completed",
"tool": "treblo",
"cost": 10,
"created_at": "2026-11-15T12:46:26Z",
"completed_at": "2026-11-15T12:48:44Z",
"result": {
"type": "audio",
"urls": [
"https://storage.bratuha.ru/results/treblo/track-1.mp3"
],
"files": [
{
"url": "https://storage.bratuha.ru/results/treblo/track-1.mp3",
"name": "track-1"
}
]
},
"error_message": null
}
{
"id": "op_uuid-123",
"status": "failed",
"tool": "treblo",
"cost": 10,
"created_at": "2026-11-15T12:46:26Z",
"completed_at": "2026-11-15T12:46:31Z",
"result": null,
"error_message": "Не удалось создать музыку."
}
Если операция завершилась ошибкой, деньги возвращаются на баланс.
Сохраните id из ответа на создание и запрашивайте статус по нему:
GET /api/v1/operations/{id}
curl -H "Authorization: Bearer brth_ваш_ключ" \
https://bratuha.ru/api/v1/operations/op_uuid-123
async function waitForTrack(id) {
while (true) {
const response = await fetch(`https://bratuha.ru/api/v1/operations/${id}`, {
headers: { Authorization: 'Bearer brth_ваш_ключ' },
})
const operation = await response.json()
if (operation.status === 'completed' || operation.status === 'failed') {
return operation
}
await new Promise((resolve) => setTimeout(resolve, 10000))
}
}
Статусы:
queued - операция создана и ждёт запуска;processing - трек создаётся;completed - готово, ссылки лежат в result;failed - не получилось, причина в error_message.Модель v2 обычно отвечает за 30-40 секунд, v3 - за 1,5-4,5 минуты. Проверять статус раз в 10 секунд достаточно, чаще раза в секунду для одной операции нельзя - придёт 429.
В result приходит аудио:
type - всегда "audio";urls - массив ссылок: одна, а при variants: "2" - две;files - те же ссылки объектами с url и name (track-1, track-2).Файл - в выбранном output_format. Продление и замена участка возвращают весь трек целиком (кроме selection_crop: true, тогда приходит только новый участок).
| Запуск | Цена |
|---|---|
| Любой режим, один трек | 10 ₽ |
variants: "2" (модель v2 или замена участка) | 15 ₽ |
Формат файла, длительность и дополнительные параметры на цену не влияют. Сумма приходит в поле cost ответа на создание и сразу списывается с баланса.
Idempotency-Key каждый POST /api/v1/operations создаёт новую операцию и списывает деньги. Чтобы безопасно повторить запрос при обрыве связи, передавайте один и тот же Idempotency-Key (до 255 символов): повтор вернёт уже созданную операцию с заголовком Idempotent-Replayed: true.id.source_audio, reference_audio) передаются внешними http/https ссылками, доступными без авторизации.instrumental: "true" и свой текст.v3 - не длиннее 4:45. Для продления: учтённая часть трека (context_seconds, по умолчанию 150 секунд) и продолжение вместе не длиннее 4:45.lyrics как есть, проверьте опечатки заранее. На русском иногда смещаются ударения - помогает переписать строку.