Генерация аудио · suno

Suno Add Instrumental

suno-add-instrumental

Suno Add Instrumental — генерация аудио от Suno, доступная через единый Ranvik API. Поддерживаемые возможности: add_instrumental, async, music.

от 7.98 ₽ / запрос

Инструментальная аранжировка для загруженной записи вокала. Версии V6, V6_WILD и V6_MINI; два варианта. Обработка асинхронная: создайте задачу, затем получите все файлы через GET /v1/tasks/{id}.

Технические характеристики

МодальностьГенерация аудио
Провайдерsuno
СтатусАктивна
ID для запросовsuno-add-instrumental

Возможности

  • Добавление аккомпанемента
  • Async
  • Генерация музыки

Цены

ЕдиницаЦена
за запрос7.98 ₽

Цены указаны в рублях. Списываются с баланса проекта при каждом успешном запросе.

Поддерживаемые параметры

Параметры передаются вендору как есть (pure proxy) — мы не валидируем их у себя на стороне. Если вендор не примет — вернётся его ошибка.

ПараметрТипДиапазон / valuesDefaultОписание
uploadUrlrequiredstring—— Прямая публичная HTTP(S)-ссылка на MP3/WAV без редиректов, до 32 МБ.
versionenumV6, V6_WILD, V6_MINIV6 Версия обработки: V6, экспериментальная V6_WILD или облегченная V6_MINI. Параметр model содержит ID инструмента Ranvik API.
titlerequiredstring—— Название новой аранжировки.
tagsrequiredstring—— Желаемые жанр, инструменты и настроение.
negativeTagsrequiredstring—— Нежелательные особенности звучания.
lyricsstring—— Необязательный текст песни.
vocalGenderenumm, f— Предпочтительный вокал: мужской или женский.
styleWeightnumbermin: 0 · max: 1— Следование стилю; до двух знаков после запятой.
weirdnessConstraintnumbermin: 0 · max: 1— Экспериментальность; до двух знаков после запятой.
audioWeightnumbermin: 0 · max: 1— Влияние исходного звучания; до двух знаков после запятой.
varietyintegermin: 0 · max: 4— Разнообразие вариантов, от 0 до 4.

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

Что возвращает API. У медиа-моделей формат зависит от режима: sync — сразу результат, async — task_id для опроса через GET /v1/tasks/{id}. Эта модель работает только в async-режиме.

Async (HTTP 202)

POST /v1/audio/speech: JSON задачи, а не бинарный файл.

ПолеТипЗначенияОписание
idstring— ID задачи.
statusstring— Начальное состояние.

Опрос статуса (GET /v1/tasks/{id})

GET /v1/tasks/{id}: готовые файлы.

ПолеТипЗначенияОписание
dataarray—
Каждый элемент:
  • url— string
  • name— string · Название дорожки при разделении.
  • role— string · В расширенном режиме: extract или remove.
  • variant— integer · Номер варианта в расширенном режиме.

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

import requests, time

headers = {"Authorization": "Bearer rk_live_..."}
r = requests.post(
    "https://api.ranvik.ru/v1/audio/speech", headers=headers,
    json={
    "model": "suno-add-instrumental",
    "version": "V6",
    "uploadUrl": "https://example.com/vocals.mp3",
    "title": "Новый день",
    "tags": "Acoustic pop, piano",
    "negativeTags": "Distortion, heavy drums"
},
    timeout=120,
)
r.raise_for_status()
task = r.json()
for _ in range(120):
    if task["status"] in ("completed", "failed", "canceled"):
        break
    time.sleep(5)
    r = requests.get("https://api.ranvik.ru/v1/tasks/" + task["id"], headers=headers, timeout=30)
    r.raise_for_status()
    task = r.json()
if task["status"] != "completed":
    raise RuntimeError("Generation status: " + task["status"])
print(task["data"] )

Замените rk_live_... на ваш ключ из кабинета.

О провайдере: Suno

Suno — генерация полноценных музыкальных треков по текстовому описанию или лирике. Поддерживает разные стили, инструменты и вокал.

Официальный сайт: https://suno.com

Документация модели у вендора: https://api.ranvik.ru/docs