Как использовать Mureka 9.5 API? Первая песня за 5 минут

TL;DR

• Что это: Mureka 9.5 — модель генерации музыки, в HiAPI у неё две линии — текст в песню принимает готовый текст и возвращает полноценную песню с ведущим вокалом, бэк-вокалом и аккомпанементом; инструментальная музыка принимает только описание и возвращает инструментал без вокала. Mureka 9.5 уже доступна в HiAPI, откройте страницу модели «текст в песню», чтобы прослушать и генерировать онлайн; новым пользователям при регистрации дарится 200 кредитов.
• Сколько стоит: каждая успешная генерация — $0.3215 (643 кредита), обе линии по одной цене, независимо от длины текста и длительности выходного файла; при ошибке предоплата возвращается. На $10 — около 31 песни.
• Как быстрее всего запустить: на странице модели вставьте текст, выберите ведущий вокал и нажмите «Запустить»; для интеграции в свой продукт используйте POST /v1/tasks с model равным mureka-9.5/lyrics-to-song, получите taskId и опрашивайте статус до получения URL.

Что такое Mureka 9.5?

Текст уже готов, не хватает только исполненной песни: линия «текст в песню» в Mureka 9.5 сводит всё это к одному запросу. Вы кладёте полный текст в lyrics, с помощью необязательного prompt задаёте жанр, настроение, инструменты, ритм и характеристики вокала, с помощью gender фиксируете, женский или мужской ведущий вокал, и за один раз получаете сведённую песню в MP3, 44.1 кГц, стерео, около 256 кбит/с.

Длина трёх реальных примеров на сайте — 1:49, 3:02 и 3:30, все они с одной линии и по одной цене за штуку. Модель не пишет текст автоматически и не принимает референсные треки или мелодии; граница входных данных — это текст плюс направление по жанру.

Сначала послушайте два реальных трека

City Night Drive с линии «текст в песню» и Wide-screen Overture с линии «инструментальная музыка» — оба получены одним запросом за $0.3215.

Прослушать: City Night Drive, английский инди-поп, 1:49

Текст в песню: City Night Drive · 1:49 · MP3 44.1 кГц стерео 256 кбит/с

Прослушать: Wide-screen Overture, кинематографичная оркестровка, 3:12

Инструментальная музыка: Wide-screen Overture · 3:12 · MP3 44.1 кГц стерео 256 кбит/с

Чем различаются две линии

	Текст в песню	Инструментальная музыка
ID модели	mureka-9.5/lyrics-to-song	mureka-9.5/instrumental
Обязательные поля	lyrics (1–5 000 символов)	prompt (1–1 024 символа)
Необязательные поля	prompt (1–2 000 символов), gender (female / male)	нет
Выход	Полноценная песня с вокалом	Инструментал без вокала
Длительность	Определяется моделью по структуре текста	Определяется моделью, параметра длительности нет
Цена за штуку	$0.3215 / раз	$0.3215 / раз

Нужна песня с вокалом — берите левую колонку, нужна фоновая музыка — правую. Ни там, ни там нельзя указать длительность; три примера инструментальной музыки на сайте — 3:12, 3:08 и 3:03.

Онлайн-проба: 4 шага

1. Откройте страницу модели «текст в песню» — прямо на ней можно послушать три примера с сайта.
2. В поле текста построчно вставьте полный текст, размечая секции маркерами вроде [Verse 1], [Chorus].
3. В поле направления стиля опишите жанр, настроение, инструменты и характеристики вокала; выберите женский или мужской ведущий вокал.
4. Нажмите «Запустить» и дождитесь завершения задачи — после этого можно воспроизводить и скачивать. Каждый раз $0.3215.

Для инструментальной музыки замените шаг 2 на описание инструментала, откройте страницу модели инструментальной музыки — те же четыре шага.

Для первой пробы можно сразу взять это направление стиля:

Warm indie-pop song with a bright female lead vocal, chiming guitars, steady live drums and a wide sing-along chorus, hopeful late-night mood.

Сгенерировать с этим промптом →

После перехода промпт подставится в поле направления стиля; добавьте четыре свои строки текста, выберите женский ведущий вокал — и можно запускать первую песню.

Подключение по API: 4 шага

1. После регистрации создайте API Key в консоли.
2. Отправьте POST https://api.hiapi.ai/v1/tasks с model и input.
3. Возьмите ID задачи из data.taskId в ответе и опрашивайте GET /v1/tasks/{taskId} или ждите колбэка.
4. Когда статус станет success, возьмите из data.output элемент с type=audio и скачайте MP3.

Текст в песню: curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mureka-9.5/lyrics-to-song",
    "input": {
      "lyrics": "[Verse 1]\nCity lights are waking up\nEvery window starts to glow\n[Chorus]\nWe keep moving through the night\nEvery shadow turns to gold",
      "prompt": "Warm indie-pop song with a bright female lead vocal, chiming guitars, steady live drums and a wide sing-along chorus, hopeful late-night mood.",
      "gender": "female"
    }
  }'

Возьмите ID задачи из ответа:

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

Инструментальная музыка: curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mureka-9.5/instrumental",
    "input": {
      "prompt": "Cinematic orchestral instrumental with a fragile piano ostinato, evolving string swells, low brass and soft timpani, hopeful then resolute, wide film-score reverb."
    }
  }'

Проверка статуса:

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

data.status последовательно может принимать значения queued, handling, success или fail.

Python: создание задачи, опрос, получение ссылки

import time
import requests

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

payload = {
    "model": "mureka-9.5/lyrics-to-song",
    "input": {
        "lyrics": "[Verse 1]\nCity lights are waking up\nEvery window starts to glow\n[Chorus]\nWe keep moving through the night\nEvery shadow turns to gold",
        "prompt": "Warm indie-pop song with a bright female lead vocal, chiming guitars, steady live drums and a wide sing-along chorus, hopeful late-night mood.",
        "gender": "female",
    },
}

resp = requests.post(BASE, headers=HEADERS, json=payload, timeout=30)
task_id = resp.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(10)

if data["status"] == "success":
    audio_url = next(item["url"] for item in data["output"] if item["type"] == "audio")
    print(audio_url)
else:
    print(data.get("error"))

Для инструментальной музыки используется та же логика опроса, меняется только отправляемое содержимое — этот код тоже работает отдельно:

import time
import requests

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

payload = {
    "model": "mureka-9.5/instrumental",
    "input": {
        "prompt": "Cinematic orchestral instrumental with a fragile piano ostinato, evolving string swells, low brass and soft timpani, hopeful then resolute, wide film-score reverb.",
    },
}

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(10)

print(next((item["url"] for item in data.get("output", []) if item["type"] == "audio"), data.get("error")))

Выходные данные и формат

Каждый запрос возвращает один MP3: 44.1 кГц, стерео, около 256 кбит/с. При скачивании ищите в data.output элемент с type равным audio; не ищите строку на верхнем уровне ответа.

Возвращаемый url истекает — перед сохранением в базу сначала перенесите файл в собственное хранилище.

Что учесть перед запуском в продакшен

1. Колбэк плюс опрос как страховка. В тело запроса можно добавить "callback": {"url": "https://yourapp.com/webhook", "when": "final"} — при переходе задачи в финальный статус придёт уведомление; уведомление может потеряться, поэтому дополните его периодическим опросом.
2. Сначала сохраняйте taskId, не отправляйте POST повторно. Каждое создание задачи тарифицируется; когда у клиента истекает таймаут, задача может быть уже создана. Сохраните taskId в базу и перед повтором проверьте статус.
3. Размечайте текст построчно. Одна строка — одна фраза, сохраняйте порядок куплетов и припевов, явно пишите маркеры секций — структура получается гораздо стабильнее; лимит 5 000 символов.
4. Явно указывайте пол ведущего вокала. Если не передать, решает модель; для серий песен или брендовых треков фиксируйте female или male, чтобы голос на одном и том же материале оставался последовательным.

FAQ

Можно оставить текст пустым, чтобы модель написала его сама? Нет. lyrics обязателен, 1–5 000 символов. Для автоматического написания текста используйте музыкальную модель с поддержкой автотекста.

Какая максимальная длина песни? Параметра длительности нет, длина определяется моделью по структуре текста. Три примера «текст в песню» на сайте — 1:49, 3:02 и 3:30, три примера инструментальной музыки — 3:12, 3:08 и 3:03.

Будет ли вокал в инструментальной музыке? Нет. Линия инструментальной музыки не генерирует вокальное исполнение, даже если в описании указан ведущий вокал; нужен вокал — переходите на линию «текст в песню».

Списываются ли деньги при неудачной генерации? Нет. Предоплата за неудачную задачу автоматически возвращается.

Запустите первую песню прямо сейчас

Вставьте приведённый выше curl в терминал, замените YOUR_API_KEY на свой ключ, а текст — на свой, и получите первый taskId. Хотите сначала посмотреть результат — просто откройте страницу модели «текст в песню» и нажмите «Запустить». Полная документация — в документации по подключению «текст в песню» и документации по инструментальной музыке.

Читайте также: Цены Mureka 9.5: $0.3215 за песню · Mureka 9.5 vs MiniMax Music 2.6 · Полный гид по промптам Mureka 9.5: 6 реальных примеров