Mirelo AI SFX 1.6 API

Mirelo AI SFX 1.6 API

Mirelo AI SFX 1.6 работает со звуковыми эффектами в четырёх режимах: озвучивает видео под действие в кадре, создаёт звук по текстовому описанию, продлевает готовую запись и перерисовывает отдельный участок в ней. Для фоновых шумов есть режим бесшовной петли, которую можно крутить по кругу.

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

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

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

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

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

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

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

Тело запроса

{
  "tool": "mirelo-ai-sfx-1-6",
  "input": {
    "generation_type": "text_to_audio",
    "...": "..."
  }
}

• tool - slug нейросети, всегда "mirelo-ai-sfx-1-6".
• input - параметры запуска. Все поля передаются прямо внутри этого объекта. Единственное вложенное поле - segment в режиме inpaint_audio.

Параметры

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

Звук для видео (video_to_video)

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

cURL

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

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: 'mirelo-ai-sfx-1-6',
    input: {
      generation_type: 'video_to_video',
      video_url: 'https://cdn.example.com/source-video-1.mp4',
      text_prompt_optional: 'Шум дождя по асфальту, шаги по лужам',
    },
  }),
})

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': 'mirelo-ai-sfx-1-6',
        'input': {
            'generation_type': 'video_to_video',
            'video_url': 'https://cdn.example.com/source-video-1.mp4',
            'text_prompt_optional': 'Шум дождя по асфальту, шаги по лужам',
        },
    },
    timeout=30,
)

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

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

Скрип и хлопок двери, 4 секунды. Стоимость - 6 ₽.

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "mirelo-ai-sfx-1-6",
  "input": {
    "generation_type": "text_to_audio",
    "text_prompt_required": "Тяжёлая деревянная дверь медленно открывается со скрипом и захлопывается",
    "audio_duration": 4,
    "upload_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: 'mirelo-ai-sfx-1-6',
    input: {
      generation_type: 'text_to_audio',
      text_prompt_required: 'Тяжёлая деревянная дверь медленно открывается со скрипом и захлопывается',
      audio_duration: 4,
      upload_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': 'mirelo-ai-sfx-1-6',
        'input': {
            'generation_type': 'text_to_audio',
            'text_prompt_required': 'Тяжёлая деревянная дверь медленно открывается со скрипом и захлопывается',
            'audio_duration': 4,
            'upload_audio_format': 'mp3',
        },
    },
    timeout=30,
)

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

Зацикленная атмосфера (text_to_audio с ambience)

10 секунд бесшовного дождя, склеенные в 20-секундный файл. Стоимость - 15 ₽: платите за audio_duration, удвоение бесплатно.

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "mirelo-ai-sfx-1-6",
  "input": {
    "generation_type": "text_to_audio",
    "text_prompt_required": "Steady rain on a cafe window, muffled city traffic outside, no music, no voices",
    "audio_duration": 10,
    "ambience": true,
    "double_output": true,
    "upload_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: 'mirelo-ai-sfx-1-6',
    input: {
      generation_type: 'text_to_audio',
      text_prompt_required: 'Steady rain on a cafe window, muffled city traffic outside, no music, no voices',
      audio_duration: 10,
      ambience: true,
      double_output: true,
      upload_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': 'mirelo-ai-sfx-1-6',
        'input': {
            'generation_type': 'text_to_audio',
            'text_prompt_required': 'Steady rain on a cafe window, muffled city traffic outside, no music, no voices',
            'audio_duration': 10,
            'ambience': True,
            'double_output': True,
            'upload_audio_format': 'mp3',
        },
    },
    timeout=30,
)

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

Продление записи (extend_audio)

Запись продлевается на 10 секунд. Стоимость - 15 ₽ при любой длине исходника. Если исходник 8 секунд, результат будет около 18 секунд.

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "mirelo-ai-sfx-1-6",
  "input": {
    "generation_type": "extend_audio",
    "audio_url": "https://cdn.example.com/source-audio-1.mp3",
    "text_prompt_optional": "Тот же дождь, в конце далёкий раскат грома",
    "append_duration": 10,
    "ambience": false,
    "upload_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: 'mirelo-ai-sfx-1-6',
    input: {
      generation_type: 'extend_audio',
      audio_url: 'https://cdn.example.com/source-audio-1.mp3',
      text_prompt_optional: 'Тот же дождь, в конце далёкий раскат грома',
      append_duration: 10,
      ambience: false,
      upload_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': 'mirelo-ai-sfx-1-6',
        'input': {
            'generation_type': 'extend_audio',
            'audio_url': 'https://cdn.example.com/source-audio-1.mp3',
            'text_prompt_optional': 'Тот же дождь, в конце далёкий раскат грома',
            'append_duration': 10,
            'ambience': False,
            'upload_audio_format': 'mp3',
        },
    },
    timeout=30,
)

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

Замена участка (inpaint_audio)

Со 2-й по 4-ю секунду вместо того, что было, появится хлопок двери. Остальная запись не меняется. Участок 2 секунды - стоимость 3 ₽.

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "mirelo-ai-sfx-1-6",
  "input": {
    "generation_type": "inpaint_audio",
    "audio_url": "https://cdn.example.com/source-audio-1.wav",
    "text_prompt_optional": "Громкий хлопок двери",
    "segment": {
      "start_s": 2,
      "end_s": 4
    },
    "upload_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: 'mirelo-ai-sfx-1-6',
    input: {
      generation_type: 'inpaint_audio',
      audio_url: 'https://cdn.example.com/source-audio-1.wav',
      text_prompt_optional: 'Громкий хлопок двери',
      segment: {
        start_s: 2,
        end_s: 4,
      },
      upload_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': 'mirelo-ai-sfx-1-6',
        'input': {
            'generation_type': 'inpaint_audio',
            'audio_url': 'https://cdn.example.com/source-audio-1.wav',
            'text_prompt_optional': 'Громкий хлопок двери',
            'segment': {
                'start_s': 2,
                'end_s': 4,
            },
            'upload_audio_format': 'mp3',
        },
    },
    timeout=30,
)

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

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

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

{
  "id": "op_uuid-123",
  "status": "queued",
  "tool": "mirelo-ai-sfx-1-6",
  "cost": 7.5,
  "balance_after": 492.5,
  "created_at": "2026-09-30T19:49:45Z"
}

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

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

{
  "id": "op_uuid-123",
  "status": "completed",
  "tool": "mirelo-ai-sfx-1-6",
  "cost": 7.5,
  "created_at": "2026-09-30T19:49:45Z",
  "completed_at": "2026-09-30T19:50:19Z",
  "result": {
    "type": "video",
    "urls": [
      "https://storage.bratuha.ru/results/mirelo-ai-sfx-1-6/video-1.mp4"
    ]
  },
  "error_message": null
}

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

Так выглядит ответ для text_to_audio, extend_audio и inpaint_audio:

{
  "id": "op_uuid-123",
  "status": "completed",
  "tool": "mirelo-ai-sfx-1-6",
  "cost": 15,
  "created_at": "2026-09-30T19:49:45Z",
  "completed_at": "2026-09-30T19:49:57Z",
  "result": {
    "type": "audio",
    "urls": [
      "https://storage.bratuha.ru/results/mirelo-ai-sfx-1-6/sound-1.mp3"
    ],
    "files": [
      {
        "url": "https://storage.bratuha.ru/results/mirelo-ai-sfx-1-6/sound-1.mp3",
        "name": "result"
      }
    ]
  },
  "error_message": null
}

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

{
  "id": "op_uuid-123",
  "status": "failed",
  "tool": "mirelo-ai-sfx-1-6",
  "cost": 7.5,
  "created_at": "2026-09-30T19:49:45Z",
  "completed_at": "2026-09-30T19:50:30Z",
  "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-20 секунд, звук для видео - за 30 секунд - 1 минуту, длинные ролики обрабатываются до нескольких минут. Опрашивать одну операцию можно не чаще раза в секунду, иначе придёт 429.

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

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

Для видео:

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

Для аудио:

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

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

В тестовом запуске video_to_video на 5-секундном ролике 864×496 пришёл MP4 той же длины и размера, со звуком AAC 44,1 кГц, моно. В проверенных запусках text_to_audio и extend_audio приходил MP3 моно 44,1 кГц, 64 кбит/с, в том числе когда в upload_audio_format был указан wav. Длина аудио: в text_to_audio - audio_duration (вдвое больше с double_output), в extend_audio - исходная запись плюс append_duration.

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

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

Минимум - 1 секунда, 1,5 ₽. Длительность видео сервер сам определяет по файлу и считает в целых секундах.

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

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

• POST /api/v1/operations не идемпотентен: каждый запрос создаёт новую операцию и списывает деньги. Не повторяйте запрос автоматически при обрыве связи.
• Операция выполняется асинхронно: сначала приходит queued, результат нужно забирать запросом статуса по id.
• Видео и аудио передаются только ссылкой: внешний http/https URL с допустимым расширением. Ссылка должна открываться без авторизации, файл - до 128 МБ.
• Длину видео и аудио сервер проверяет ещё до создания операции. Если файл недоступен, его длину не удалось определить или она вне допустимых пределов (видео до 60 секунд, запись для продления 3-59 секунд, для замены участка до 10 секунд), API вернёт ошибку 400, операция не создастся и деньги не спишутся.
• В extend_audio сумма исходной записи и append_duration не может быть больше 60 секунд, иначе API вернёт 400.
• В inpaint_audio участок начинается не раньше 1-й секунды и длится от 1 до 8 секунд. Первую секунду записи этим режимом заменить нельзя.
• Числовые поля (audio_duration, append_duration, segment.start_s, segment.end_s) принимают только целые числа.
• Для фоновых шумов включайте ambience: true: получится петля без заметного шва, которую удобно крутить под видео любой длины.
• Одна операция - один результат. Для нескольких вариантов создайте несколько операций.