Как использовать API Mirelo SFX 2.0? Создайте первый звуковой эффект за 5 минут

TL;DR

• Что это: модель генерации звука по тексту — одно описание превращается в один WAV длиной 1–30 секунд (PCM 16-bit / 48 kHz / моно). Откройте страницу модели Mirelo SFX 2.0, напишите одно предложение и сразу слушайте. Mirelo SFX 2.0 уже доступен в HiAPI, новые пользователи получают 200 кредитов при регистрации.
• Сколько стоит: оплата по секундам выходного аудио, $0.0215 (43 кредита) за секунду, минимум 1 секунда; 5 секунд — $0.1075, 30 секунд — $0.645.
• Как вызвать быстрее всего: на странице модели заполните описание, выберите длительность и отправьте; для интеграции в продукт используйте POST /v1/tasks, в model укажите mirelo-sfx-2.0, а в input только prompt и duration.

Что такое Mirelo SFX 2.0

На входе всего два поля: prompt и duration. Описание — от 1 до 2 000 символов: укажите источник звука, материал, действие, расстояние и окружение, затем добавьте атаку и хвост; duration — целое число секунд от 1 до 30, по умолчанию 5. На выходе всегда один WAV, PCM 16-bit, 48 kHz, моно — вариантов формата нет.

Модель создаёт только отдельные звуковые эффекты и атмосферные шумы: один запрос — одно звуковое событие, без песен, вокала и диалогов. Нужно добавить удар в монтаже, получить звук обратной связи UI в игре или фоновый шум дождливой ночи для короткого видео — это её задача.

Этот удар молота в примере выдаётся за 1 секунду, $0.0215. И переходный процесс, и металлический остаточный звон умещаются в этой секунде:

Послушать: удар молота по стальной балке, WAV 1 секунда

A single heavy hammer strike on a steel beam in a large empty warehouse, sharp transient, long metallic ring, close perspective.

Сгенерировать с этим промптом → Ссылка только предзаполняет описание; чтобы получить именно этот звук, после открытия установите duration в 1 секунду.

Ещё один пример атмосферного звука длиной 10 секунд — та же модель, тот же набор полей:

Послушать: дождливая ночь на металлической крыше, WAV 10 секунд

Онлайн-проба: 4 шага до первого звука

1. Откройте страницу модели Mirelo SFX 2.0; при регистрации вы получите 200 кредитов.
2. Вставьте в поле описания тот промпт про удар молота или замените его на нужный вам звук.
3. Установите duration в 1–3 секунды, сначала послушайте атаку и хвост.
4. Нажмите «Отправить» — в плеере появится WAV, его можно сразу скачать.

Не пропускайте третий шаг. Одно и то же описание при 1 и 10 секундах даёт разные результаты; сначала короткая проба, потом длинная версия — так вы экономите на повторных генерациях.

Подключение API: 4 шага до рабочего вызова

1. Создайте API-ключ в консоли.
2. POST https://api.hiapi.ai/v1/tasks: в model укажите mirelo-sfx-2.0, в input поместите prompt и duration.
3. Получите возвращённый taskId, дождитесь уведомления по callback или опрашивайте GET /v1/tasks/{taskId}.
4. Когда status станет success, возьмите из output элемент с type равным audio и скачайте WAV по его url.

Рабочий curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mirelo-sfx-2.0",
    "input": {
      "prompt": "A single heavy hammer strike on a steel beam in a large empty warehouse, sharp transient, long metallic ring, close perspective.",
      "duration": 1
    }
  }'

ID задачи в ответе находится в data.taskId:

{"code":200,"data":{"taskId":"tk-hiapi-..."},"message":"success"}

По этому ID проверьте статус:

curl -s https://api.hiapi.ai/v1/tasks/YOUR_TASK_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

data.status проходит через queued, handling, success или fail. При успехе найдите в data.output элемент с type равным audio.

Версия на Python: создание, опрос и скачивание в одном скрипте

import requests
import time

BASE = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

payload = {
    "model": "mirelo-sfx-2.0",
    "input": {
        "prompt": "A single heavy hammer strike on a steel beam in a large empty warehouse, sharp transient, long metallic ring, close perspective.",
        "duration": 1,
    },
}

task_id = requests.post(BASE, headers=HEADERS, json=payload, timeout=30).json()["data"]["taskId"]

while True:
    data = requests.get(f"{BASE}/{task_id}", headers=HEADERS, timeout=30).json()["data"]
    if data["status"] in ("success", "fail"):
        break
    time.sleep(2)

if data["status"] == "success":
    audio_url = next(item["url"] for item in data["output"] if item["type"] == "audio")
    with open("effect.wav", "wb") as f:
        f.write(requests.get(audio_url, timeout=60).content)
    print("saved effect.wav")
else:
    print(data.get("error"))

Задачи звуковых эффектов намного короче видеозадач: интервала опроса в 2 секунды достаточно, ждать полных 3 секунды не нужно.

Как писать описание: пять элементов

Дополнительных параметров нет, prompt — это вся поверхность управления. Пишите по этим пяти пунктам, и всё получится с первого раза:

Элемент	Что писать	Соответствующая фраза в примере
Источник звука	Что издаёт звук	a heavy hammer strike
Материал	Материал звучащего тела	on a steel beam
Действие	Как издаётся звук и с какой силой	single, heavy
Расстояние и окружение	Где слушатель и насколько велико пространство	in a large empty warehouse, close perspective
Атака и хвост	Насколько быстро начало и насколько длинен конец	sharp transient, long metallic ring

Опускайте измерения, в которых не уверены, и не пишите прилагательные вроде «примерно» или «кинематографично» — каждое конкретное существительное в описании отражается на звуке. Завершающая фраза вроде «no music and no voices» стоит того, чтобы её оставить: она разом исключает нежелательные слои.

Как выбрать длительность

Сначала проверьте на 1–3 секундах, верны ли тембр, атака и хвост, а когда всё готово, увеличьте duration до целевой длины. Одно и то же описание при 3 и 10 секундах даёт разную плотность событий: короткая версия — для проверки направления, длинная — для финального результата, и это гораздо дешевле, чем сразу запускать 30 секунд.

• Удары, UI, нажатия → 1–3 секунды.
• Атмосферные шумы, фоновый шум, атмосфера помещения → 10–30 секунд.
• Нужно подогнать под длину кадра → просто укажите целые секунды кадра, и модель выдаст ровно столько.

4 вещи, которые нужно учесть перед запуском в продакшен

1. Callback плюс опрос как страховка. Добавьте в тело запроса "callback": {"url": "https://yourapp.com/webhook", "when": "final"} — задача уведомит вас при переходе в терминальное состояние; уведомление может потеряться, поэтому настройте дополнительный периодический GET /v1/tasks/{taskId}.
2. Идемпотентность по taskId. success и fail — оба терминальные состояния, по одному taskId может прийти несколько уведомлений; перед обработкой проверьте дедупликацию в базе.
3. Ссылки на артефакты истекают. url в output — временный адрес; получив его, сразу пересохраните файл в своё хранилище и не используйте как долговременный CDN.
4. Одно описание — одно событие. Удар плюс падение обломков, шум дождя плюс гром плюс лай собаки — генерируйте отдельными запросами и смешивайте на постпродакшене; так контролируемее, чем пытаться уместить всё в одно предложение.

Частые вопросы

Может ли Mirelo SFX 2.0 генерировать песни или вокал? Нет. Она создаёт только отдельные звуковые эффекты и атмосферные шумы длительностью до 30 секунд. Для музыки используйте музыкальную модель, для озвучки — модель речи.

Что будет, если не указать duration? Генерация пойдёт на 5 секунд и спишет $0.1075. Нужна другая длина — укажите её явно, целым числом от 1 до 30.

Можно ли выбрать MP3 или стерео на выходе? Нет, всегда один WAV, PCM 16-bit, 48 kHz, моно. Нужен другой формат — конвертируйте на постпродакшене.

Какая максимальная длина описания? 2 000 символов — достаточно, чтобы уместить полную звуковую спецификацию.

Запустите первый звук прямо сейчас

Скопируйте тот промпт про удар молота, откройте страницу модели Mirelo SFX 2.0, установите duration в 1 секунду и за $0.0215 послушайте полноценный удар. Убедившись в результате, подставьте те же два поля в curl выше и подключите к своему процессу. Полные параметры — в документации по интеграции.

Читайте также: Цены Mirelo SFX 2.0 · vs ElevenLabs Sound Effects v2 · 4 реальных промпта для звуковых эффектов