Sonilo 1.1 API

Sonilo 1.1 API

Sonilo 1.1 делает музыку и звуковые эффекты. Звук можно получить по текстовому описанию или сразу под готовое видео: модель смотрит на ролик и подбирает музыку или шумы под то, что происходит в кадре. В видеорежимах можно получить либо отдельную звуковую дорожку, либо сам ролик уже с новым звуком.

Типичные задачи:

• фоновая музыка для роликов, подкастов и презентаций;
• озвучка немого видео шумами: шаги, дождь, машины, треск костра;
• быстрый саундтрек под ролик, сгенерированный другой нейросетью без звука.

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

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

• Endpoint: POST /api/v1/operations
• Авторизация: Authorization: Bearer brth_...
• Выполнение асинхронное: запрос сразу возвращает id и стартовый статус queued.

Режим выбирается параметром generation_type. Всего режимов шесть:

У каждого режима свои поля: описание, длительность и ссылка на видео называются по-разному, поэтому смотрите колонку «Описание» в таблице параметров. Поля другого режима передавать не нужно, они не учитываются.

Тело запроса

{
  "tool": "sonilo-1-1",
  "input": {
    "generation_type": "text_to_music",
    "...": "..."
  }
}

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

Параметры

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

Во всех примерах с видео используется ролик длиной 10 секунд.

Музыка по описанию (text_to_music)

30 секунд фоновой музыки. Стоимость - 45 ₽.

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "sonilo-1-1",
  "input": {
    "generation_type": "text_to_music",
    "text_music_prompt": "Спокойный лоу-фай для фона: мягкие клавишные, тёплый бас, неторопливый ритм, уютное вечернее настроение",
    "text_music_duration": 30
  }
}'

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: 'sonilo-1-1',
    input: {
      generation_type: 'text_to_music',
      text_music_prompt: 'Спокойный лоу-фай для фона: мягкие клавишные, тёплый бас, неторопливый ритм, уютное вечернее настроение',
      text_music_duration: 30,
    },
  }),
})

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': 'sonilo-1-1',
        'input': {
            'generation_type': 'text_to_music',
            'text_music_prompt': 'Спокойный лоу-фай для фона: мягкие клавишные, тёплый бас, неторопливый ритм, уютное вечернее настроение',
            'text_music_duration': 30,
        },
    },
    timeout=30,
)

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

Музыка под видео (video_to_music)

Модель смотрит ролик и возвращает отдельную дорожку с музыкой под него. Стоимость для 10-секундного видео - 15 ₽.

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "sonilo-1-1",
  "input": {
    "generation_type": "video_to_music",
    "video_music_video_url": "https://cdn.example.com/source-video-1.mp4",
    "video_music_prompt": "Лёгкая акустическая гитара, светлое настроение"
  }
}'

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: 'sonilo-1-1',
    input: {
      generation_type: 'video_to_music',
      video_music_video_url: 'https://cdn.example.com/source-video-1.mp4',
      video_music_prompt: 'Лёгкая акустическая гитара, светлое настроение',
    },
  }),
})

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': 'sonilo-1-1',
        'input': {
            'generation_type': 'video_to_music',
            'video_music_video_url': 'https://cdn.example.com/source-video-1.mp4',
            'video_music_prompt': 'Лёгкая акустическая гитара, светлое настроение',
        },
    },
    timeout=30,
)

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

Видео с музыкой (video_to_video_music)

На выходе тот же ролик, но уже с музыкой. С keep_speech_vocal: true речь из исходника остаётся, а музыка звучит под ней тише. Стоимость для 10-секундного видео - 15 ₽.

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "sonilo-1-1",
  "input": {
    "generation_type": "video_to_video_music",
    "video_video_music_video_url": "https://cdn.example.com/source-video-1.mp4",
    "video_video_music_prompt": "Негромкая эмбиент-музыка без ударных",
    "keep_speech_vocal": true
  }
}'

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: 'sonilo-1-1',
    input: {
      generation_type: 'video_to_video_music',
      video_video_music_video_url: 'https://cdn.example.com/source-video-1.mp4',
      video_video_music_prompt: 'Негромкая эмбиент-музыка без ударных',
      keep_speech_vocal: true,
    },
  }),
})

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': 'sonilo-1-1',
        'input': {
            'generation_type': 'video_to_video_music',
            'video_video_music_video_url': 'https://cdn.example.com/source-video-1.mp4',
            'video_video_music_prompt': 'Негромкая эмбиент-музыка без ударных',
            'keep_speech_vocal': True,
        },
    },
    timeout=30,
)

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

Звуковой эффект по описанию (text_to_sound_effects)

Пятисекундный звук костра в MP3. Стоимость - 7,5 ₽.

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "sonilo-1-1",
  "input": {
    "generation_type": "text_to_sound_effects",
    "text_sfx_prompt": "Потрескивание костра в тихом лесу, иногда щёлкают сухие ветки",
    "text_sfx_duration": 5,
    "audio_format": "mp3"
  }
}'

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: 'sonilo-1-1',
    input: {
      generation_type: 'text_to_sound_effects',
      text_sfx_prompt: 'Потрескивание костра в тихом лесу, иногда щёлкают сухие ветки',
      text_sfx_duration: 5,
      audio_format: 'mp3',
    },
  }),
})

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': 'sonilo-1-1',
        'input': {
            'generation_type': 'text_to_sound_effects',
            'text_sfx_prompt': 'Потрескивание костра в тихом лесу, иногда щёлкают сухие ветки',
            'text_sfx_duration': 5,
            'audio_format': 'mp3',
        },
    },
    timeout=30,
)

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

Звуки под видео (video_to_sound_effects)

Отдельная дорожка с шумами под происходящее в кадре, в формате WAV. Стоимость для 10-секундного видео - 15 ₽.

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "sonilo-1-1",
  "input": {
    "generation_type": "video_to_sound_effects",
    "video_sfx_video_url": "https://cdn.example.com/source-video-1.mp4",
    "video_sfx_prompt": "Шум дождя по асфальту и шаги по лужам",
    "audio_format": "wav"
  }
}'

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: 'sonilo-1-1',
    input: {
      generation_type: 'video_to_sound_effects',
      video_sfx_video_url: 'https://cdn.example.com/source-video-1.mp4',
      video_sfx_prompt: 'Шум дождя по асфальту и шаги по лужам',
      audio_format: 'wav',
    },
  }),
})

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': 'sonilo-1-1',
        'input': {
            'generation_type': 'video_to_sound_effects',
            'video_sfx_video_url': 'https://cdn.example.com/source-video-1.mp4',
            'video_sfx_prompt': 'Шум дождя по асфальту и шаги по лужам',
            'audio_format': 'wav',
        },
    },
    timeout=30,
)

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

Видео со звуковыми эффектами (video_to_video_sound_effects)

Немой ролик возвращается уже со звуком. Стоимость для 10-секундного видео - 15 ₽.

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "sonilo-1-1",
  "input": {
    "generation_type": "video_to_video_sound_effects",
    "video_video_sfx_video_url": "https://cdn.example.com/source-video-1.mp4",
    "video_video_sfx_prompt": "Шум дождя по асфальту, шаги по лужам, редкие машины вдали",
    "audio_format": "mp3"
  }
}'

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: 'sonilo-1-1',
    input: {
      generation_type: 'video_to_video_sound_effects',
      video_video_sfx_video_url: 'https://cdn.example.com/source-video-1.mp4',
      video_video_sfx_prompt: 'Шум дождя по асфальту, шаги по лужам, редкие машины вдали',
      audio_format: 'mp3',
    },
  }),
})

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': 'sonilo-1-1',
        'input': {
            'generation_type': 'video_to_video_sound_effects',
            'video_video_sfx_video_url': 'https://cdn.example.com/source-video-1.mp4',
            'video_video_sfx_prompt': 'Шум дождя по асфальту, шаги по лужам, редкие машины вдали',
            'audio_format': 'mp3',
        },
    },
    timeout=30,
)

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

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

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

{
  "id": "op_uuid-123",
  "status": "queued",
  "tool": "sonilo-1-1",
  "cost": 7.5,
  "balance_after": 492.5,
  "created_at": "2026-09-30T12:46:26Z"
}

• cost - сколько списано за операцию, в рублях.
• balance_after - баланс после списания.

Ответ после завершения: режимы с видео на выходе

Так выглядит ответ для video_to_video_music и video_to_video_sound_effects:

{
  "id": "op_uuid-123",
  "status": "completed",
  "tool": "sonilo-1-1",
  "cost": 7.5,
  "created_at": "2026-09-30T12:46:26Z",
  "completed_at": "2026-09-30T12:46:53Z",
  "result": {
    "type": "video",
    "urls": [
      "https://storage.bratuha.ru/results/sonilo-1-1/video-1.mp4"
    ]
  },
  "error_message": null
}

Ответ после завершения: режимы с аудио на выходе

Так выглядит ответ для text_to_music, video_to_music, text_to_sound_effects и video_to_sound_effects:

{
  "id": "op_uuid-123",
  "status": "completed",
  "tool": "sonilo-1-1",
  "cost": 7.5,
  "created_at": "2026-09-30T12:46:26Z",
  "completed_at": "2026-09-30T12:46:40Z",
  "result": {
    "type": "audio",
    "urls": [
      "https://storage.bratuha.ru/results/sonilo-1-1/sound-1.mp3"
    ],
    "files": [
      {
        "url": "https://storage.bratuha.ru/results/sonilo-1-1/sound-1.mp3",
        "name": "result"
      }
    ]
  },
  "error_message": null
}

Ответ при ошибке

{
  "id": "op_uuid-123",
  "status": "failed",
  "tool": "sonilo-1-1",
  "cost": 7.5,
  "created_at": "2026-09-30T12:46:26Z",
  "completed_at": "2026-09-30T12:46:45Z",
  "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 waitForResult(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, 5000))
  }
}

Статус операции:

• queued - операция создана и ждёт запуска;
• processing - звук генерируется;
• completed - готово, ссылка лежит в result;
• failed - не получилось, причина в error_message.

Обычно результат готов за время от 10 секунд до 1-2 минут, длинные видео и длинная музыка обрабатываются дольше. Опрашивать одну операцию можно не чаще раза в секунду, иначе придёт 429.

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

Тип результата зависит от режима:

Для видео:

{
  "type": "video",
  "urls": [
    "https://storage.bratuha.ru/results/sonilo-1-1/video-1.mp4"
  ]
}

Для аудио:

{
  "type": "audio",
  "urls": [
    "https://storage.bratuha.ru/results/sonilo-1-1/sound-1.mp3"
  ],
  "files": [
    {
      "url": "https://storage.bratuha.ru/results/sonilo-1-1/sound-1.mp3",
      "name": "result"
    }
  ]
}

• type - "audio" или "video", смотрите таблицу выше.
• urls - массив из одной ссылки на готовый файл. Это поле есть всегда, берите ссылку отсюда.
• files - для аудио дополнительно приходит та же ссылка в виде объекта с url и name.

В тестовом запуске video_to_video_sound_effects на 5-секундном видео 864×496 пришёл MP4 той же длины и размера, со звуком AAC 44,1 кГц.

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

Все режимы стоят одинаково - 1,5 ₽ за секунду результата. От чего считаются секунды:

• text_to_music - от text_music_duration;
• text_to_sound_effects - от text_sfx_duration;
• режимы с видео - от длительности исходного видео. Её сервер сам определяет по файлу и считает в целых секундах.

Описание, audio_format и keep_speech_vocal на цену не влияют. Точная сумма приходит в поле cost ответа на создание операции и сразу списывается с баланса.

Обратите внимание на значения по умолчанию: если в text_to_music не передать text_music_duration, будет сгенерировано 90 секунд за 135 ₽. Всегда указывайте длительность явно.

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

• POST /api/v1/operations не идемпотентен: каждый запрос создаёт новую операцию и списывает деньги. Не повторяйте запрос автоматически при обрыве связи.
• Операция выполняется асинхронно: сначала приходит queued, результат нужно забирать запросом статуса по id.
• Видео передаётся только ссылкой: внешний http/https URL с расширением .mp4, .mov или .webm. Адреса localhost и внутренних сетей не принимаются.
• Длительность видео сервер проверяет ещё до создания операции. Если файл недоступен по ссылке, больше 128 МБ или его длину не удалось определить, API вернёт ошибку 400, операция не создастся и деньги не спишутся.
• Для длинного видео заранее посчитайте цену: минута ролика стоит 90 ₽ в любом видеорежиме.
• В видеорежимах *_prompt необязателен, но короткая подсказка вроде «только шум дождя, без музыки» помогает получить именно то, что нужно.
• Если в исходном видео есть речь и её нужно сохранить, используйте video_to_video_music с keep_speech_vocal: true. В остальных видеорежимах такого параметра нет.
• Одна операция - один результат. Для нескольких вариантов создайте несколько операций.