· reAPI Team
Mureka api tutorial
Mureka API в reAPI принимает текст песни и описание стиля, возвращает ID задачи, а после завершения — URL песен. Порядок отправки и проверки основан на документации.

Для запроса Mureka API в reAPI нужны модель mureka-v9-song и текст песни в lyrics. По документации сначала возвращается ID задачи, а после завершения — ссылки на песни. Один запрос позволяет заказать до 3 песен в формате mp3, wav или flac.[1]
Руководство относится именно к этому интерфейсу reAPI и основано на публичной документации и реализации, проверенных 22 октября 2026 года. Примеры не отправлялись для генерации аудио. Они показывают структуру запроса и обработку результата, но не подтверждают скорость, музыкальное качество, точность следования референсу или актуальность модели как самой новой. Обложка — концептуальная иллюстрация, а не результат генерации аудио.
Главное
- Слова для исполнения помещайте в
lyrics, а музыкальные указания — в необязательныйprompt.[1] - Начните с
number_of_songs: 1. Документированный диапазон — 1–3; количество влияет на стоимость.[1] - После отправки сохраните полученный
idи проверяйте эту задачу до завершения.[2] - После
completedчитайтеoutput.audio_urls; для длительного хранения копируйте файлы в своё хранилище.[2]
mureka api key
Запросы ниже отправляются на reapi.ai и требуют API-ключ reAPI. В панели reAPI откройте API Keys, создайте ключ и сохраните его при отображении. Передавайте его через Authorization: Bearer .... Руководство по аутентификации описывает создание ключей и ошибки доступа.[3]
Храните ключ на сервере или в системе управления секретами. Переменная оболочки REAPI_API_KEY ниже обозначает это секретное значение; само руководство ключ не предоставляет. Не включайте действующий ключ в браузерный JavaScript, снимки экрана или публичный репозиторий. Аккаунт или ключ другого сервиса не заменяет учётные данные, выданные reAPI.
mureka api docs
Справочник Mureka V9 Song разделяет исполняемый текст и музыкальные инструкции. Поле lyrics обязательно и принимает до 3000 символов. Необязательное prompt принимает до 1024 символов и может описывать жанр, настроение, инструменты, характер вокала или темп.[1]
Например, куплет и припев задайте в lyrics, а указание «мягкая фортепианная поп-музыка со сдержанной перкуссией» — в prompt. Это примеры входных данных, а не проверенный рецепт. Если записать слова только в описание стиля, обязательное поле текста песни останется незаполненным.
| Поле | Документированный ввод | Выбор для первого запроса |
|---|---|---|
model | mureka-v9-song | Используйте точный идентификатор. |
lyrics | Обязательно; до 3000 символов | Укажите свой текст песни. |
prompt | Необязательно; до 1024 символов | Опишите желаемый музыкальный стиль. |
number_of_songs | Целое число 1–3; по умолчанию 1 | Укажите 1 для одной песни. |
output_format | mp3, wav, flac; по умолчанию mp3 | Выберите нужный приложению формат. |
reference_id, vocal_id, melody_id | Необязательные существующие ID референсов | Опустите, если нет действующих ID. |
Поля референсов принимают ID, а не локальные имена файлов, аудио-URL или произвольные описания. В этом руководстве нет endpoint для загрузки или процедуры создания таких ID. Для базового сценария с текстом и стилем их можно опустить. Добавляйте ID, только если уже располагаете действующим референсом для соответствующего поля. Наличие настройки референса не доказывает, насколько точно полученная песня ему последует.[1]
Mureka api tutorial
Это пример запроса на основе документации. Короткий текст песни служит иллюстрацией. Перед тем как решить выполнить запрос, замените его своим материалом и настройте ключ в серверном окружении. Отправка запроса генерации может привести к списанию средств.
curl https://reapi.ai/api/v1/audio/generations \
-H "Authorization: Bearer $REAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "mureka-v9-song",
"lyrics": "Morning light across the floor\nI leave a note beside the door",
"prompt": "Soft piano pop with restrained percussion",
"number_of_songs": 1,
"output_format": "mp3"
}'Сохраните id из ответа POST вместе с отправленными настройками. Присвойте его переменной TASK_ID и проверяйте статус с той же аутентификацией:
curl "https://reapi.ai/api/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $REAPI_API_KEY"Следующее действие приложения зависит от ответа на запрос статуса.[2]
status | Действие приложения |
|---|---|
processing | Оставить задачу в ожидании. ID задачи ещё не является готовым аудиофайлом. |
completed | Прочитать output.audio_urls и предложить пользователю полученные файлы. |
failed | Прочитать error и usage.credits, прекратить ожидание успешного результата. |
Истечение времени опроса в вашем приложении не доказывает сбой генерации. Сохраните ID для повторной проверки, а не создавайте новую генерацию автоматически. Справочник задач описывает опрос и ошибки. При HTTP 429 соблюдайте Retry-After; не повторяйте запрос немедленно в цикле без паузы.
mureka api pricing
Документированная единица оплаты — сгенерированная песня. number_of_songs задаёт количество; prompt, формат вывода и необязательные референсы не являются отдельными параметрами цены в документированном контракте этой модели.[1] Проверьте текущую оценку на странице Mureka V9 Song с нужным количеством песен.
Сам опрос статуса не расходует кредиты. usage.credits — итоговая сводка расчёта в целых кредитах, которую нужно читать вместе со status: ноль при processing не означает бесплатную генерацию. Неудачная задача может показать ноль или удержанную сумму; нельзя считать, что каждый сбой даёт полный возврат.[2] Новый POST для другой вариации — это новая генерация, а не проверка состояния.
Mureka api download
После completed обрабатывайте output.audio_urls как массив, даже если заказана одна песня. Согласно документации, на каждую сгенерированную песню возвращается одна ссылка в выбранном формате. Если приложение допускает несколько песен, не сохраняйте только первый результат без уведомления.[1]
Для архива скачайте файлы и храните их по собственным правилам. Контракт задач не гарантирует постоянное хранение URL результатов.[2] Свяжите ID задачи, параметры, статус и адреса сохранённых файлов, чтобы отличать незавершённую задачу от готовой песни, которую ещё не скопировали.
При первой интеграции Mureka API начните с минимального запроса выше, обработайте все три состояния и проверьте полученное аудио перед использованием в рабочем процессе. Страница модели содержит текущую оценку, а API-справочник — полный контракт полей.
Связанные запросы об API
mureka v9 api
Руководство охватывает mureka-v9-song в reAPI. Идентификатор определяет рамки примера и не означает, что V9 — новейший выпуск Mureka.
mureka api documentation
Справочник reAPI по ссылке описывает этот endpoint и поля. У других интерфейсов могут отличаться аутентификация, пути и параметры.
mureka api cost
Проверьте страницу модели с нужным количеством песен, а окончательное списание — в расчёте задачи.
mureka api platform
В примерах используется reAPI. При настройке клиента проверяйте вместе базовый URL, источник учётных данных и схему запроса.
Источники
[1] Mureka V9 Song API. Проверено 22 октября 2026 года.
[2] Задачи. Проверено 22 октября 2026 года.
[3] Аутентификация. Проверено 22 октября 2026 года.