Sonilo 1.0 API

Sonilo 1.0 API

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

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

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

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

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

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

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

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

Если нужно получить сразу видео с новым звуком или сохранить речь из исходного ролика, посмотрите более новую версию - Sonilo 1.1 (sonilo-1-1). Названия полей и лимиты там другие.

Тело запроса

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

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

Параметры

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

Музыка по описанию (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",
  "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',
    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',
        '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)

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

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "sonilo",
  "input": {
    "generation_type": "video_to_music",
    "video_music_video": "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',
    input: {
      generation_type: 'video_to_music',
      video_music_video: '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',
        'input': {
            'generation_type': 'video_to_music',
            'video_music_video': 'https://cdn.example.com/source-video-1.mp4',
            'video_music_prompt': 'Спокойная фортепианная мелодия под дождливую улицу',
        },
    },
    timeout=30,
)

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

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

Четырёхсекундный скрип двери в MP3. Стоимость - 6 ₽.

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "sonilo",
  "input": {
    "generation_type": "text_to_sfx",
    "text_sfx_prompt": "Тяжёлая деревянная дверь медленно скрипит и с глухим стуком захлопывается, пустой каменный коридор с эхом, без музыки и голосов",
    "text_sfx_duration": 4,
    "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',
    input: {
      generation_type: 'text_to_sfx',
      text_sfx_prompt: 'Тяжёлая деревянная дверь медленно скрипит и с глухим стуком захлопывается, пустой каменный коридор с эхом, без музыки и голосов',
      text_sfx_duration: 4,
      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',
        'input': {
            'generation_type': 'text_to_sfx',
            'text_sfx_prompt': 'Тяжёлая деревянная дверь медленно скрипит и с глухим стуком захлопывается, пустой каменный коридор с эхом, без музыки и голосов',
            'text_sfx_duration': 4,
            'audio_format': 'mp3',
        },
    },
    timeout=30,
)

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

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

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

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "sonilo",
  "input": {
    "generation_type": "video_to_sfx",
    "video_sfx_video": "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',
    input: {
      generation_type: 'video_to_sfx',
      video_sfx_video: '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',
        'input': {
            'generation_type': 'video_to_sfx',
            'video_sfx_video': 'https://cdn.example.com/source-video-1.mp4',
            'video_sfx_prompt': 'Шум дождя по асфальту и шаги по лужам, без музыки',
            'audio_format': 'wav',
        },
    },
    timeout=30,
)

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

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

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

{
  "id": "op_uuid-123",
  "status": "queued",
  "tool": "sonilo",
  "cost": 7.5,
  "balance_after": 492.5,
  "created_at": "2026-09-30T19:49:42Z"
}

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

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

Так выглядит ответ для музыки и для эффектов в mp3 и wav:

{
  "id": "op_uuid-123",
  "status": "completed",
  "tool": "sonilo",
  "cost": 7.5,
  "created_at": "2026-09-30T19:49:42Z",
  "completed_at": "2026-09-30T19:50:16Z",
  "result": {
    "type": "audio",
    "urls": [
      "https://storage.bratuha.ru/results/sonilo/music-1.mp3"
    ],
    "files": [
      {
        "url": "https://storage.bratuha.ru/results/sonilo/music-1.mp3",
        "name": "result"
      }
    ]
  },
  "error_message": null
}

Ответ после завершения: эффекты в aac

Файл AAC может прийти как файл общего типа: type будет "file", а массива urls в ответе нет.

{
  "id": "op_uuid-123",
  "status": "completed",
  "tool": "sonilo",
  "cost": 7.5,
  "created_at": "2026-09-30T19:49:42Z",
  "completed_at": "2026-09-30T19:50:10Z",
  "result": {
    "type": "file",
    "files": [
      {
        "url": "https://storage.bratuha.ru/results/sonilo/sound-1.aac",
        "name": "result"
      }
    ]
  },
  "error_message": null
}

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

{
  "id": "op_uuid-123",
  "status": "failed",
  "tool": "sonilo",
  "cost": 7.5,
  "created_at": "2026-09-30T19:49:42Z",
  "completed_at": "2026-09-30T19:50:05Z",
  "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.

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

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

Обычный результат:

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

• type - "audio". Для звуковых эффектов в aac может быть "file", тогда в результате есть только files.
• urls - массив из одной ссылки на готовый файл, приходит при type: "audio".
• files - та же ссылка в виде объекта с url и name. Это поле есть в обоих вариантах, поэтому надёжнее всего брать ссылку из files[0].url.

Если нужен предсказуемый аудиоответ для эффектов, передавайте audio_format явно, например mp3 или wav.

В тестовом запуске video_to_music на 5-секундном видео пришёл MP3 длиной 5,2 секунды, стерео, 44,1 кГц: длина музыки почти совпадает с длиной ролика.

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

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

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

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

Длительность в текстовых режимах передавайте целым числом: дробное значение API отклонит с 400 validation_error.

Обратите внимание на значения по умолчанию: если в text_to_sfx не передать text_sfx_duration, будет сгенерировано 15 секунд за 22,5 ₽, а в text_to_music без text_music_duration - 30 секунд за 45 ₽. Для коротких эффектов всегда указывайте длительность явно.

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

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