Suno Add Instrumental API
suno-add-instrumental — генерация аудио-модель от Suno.
add_instrumentalasyncmusic
Попробуйте прямо здесь
Suno Add Instrumental Открыть в песочнице
Что умеет Suno Add Instrumental
- Добавление аккомпанемента
- Async
- Генерация музыки
Стоимость
за запрос
7.98 ₽
Цены указаны в рублях и списываются с баланса проекта за успешные запросы. Надбавки (+) суммируются с базовой ставкой.
Технические характеристики
Vendor
suno
Modality
audio
Suno Add Instrumental API для создания инструментальных аранжировок
Suno Add Instrumental — аудиомодель провайдера Suno для дополнения вокальной или акапельной записи инструментальной аранжировкой. Ее особенность — создание нового музыкального сопровождения вокруг исходной партии, что удобно для демо, ремиксов и альтернативных версий трека. В API-сценарии можно передать прямую публичную ссылку на аудио и получить результат после асинхронной обработки.
Параметры запроса
Параметры, которые принимает модель. Передаются в теле запроса.
ПараметрТипДиапазон / значенияПо умолчаниюОписание
uploadUrlreqstring
—
—Прямая публичная HTTP(S)-ссылка на MP3/WAV без редиректов, до 32 МБ.
versionenum
V6, V6_WILD, V6_MINI
V6Версия обработки: V6, экспериментальная V6_WILD или облегченная V6_MINI. Параметр model содержит ID инструмента Ranvik API.
titlereqstring
—
—Название новой аранжировки.
tagsreqstring
—
—Желаемые жанр, инструменты и настроение.
negativeTagsreqstring
—
—Нежелательные особенности звучания.
lyricsstring
—
—Необязательный текст песни.
vocalGenderenum
m, f
—Предпочтительный вокал: мужской или женский.
styleWeightnumber
min: 0 · max: 1
—Следование стилю; до двух знаков после запятой.
weirdnessConstraintnumber
min: 0 · max: 1
—Экспериментальность; до двух знаков после запятой.
audioWeightnumber
min: 0 · max: 1
—Влияние исходного звучания; до двух знаков после запятой.
varietyinteger
min: 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— stringname— string · Название дорожки при разделении.role— string · В расширенном режиме: extract или remove.variant— integer · Номер варианта в расширенном режиме.
Пример кода
suno-add-instrumental_example.py
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"] )Частые вопросы о Suno Add Instrumental
Это аудиомодель Suno, которая дополняет вокальную или акапельную запись инструментальной аранжировкой и помогает быстро собрать новую версию трека.
Модель превращает чистый вокал или музыкальный набросок в более цельную композицию, помогая готовить демо, ремиксы и варианты аранжировки.
Зарегистрируйтесь в Ranvik API, создайте ключ в личном кабинете и подключайте его к приложению по документации сервиса. Один ключ подходит для разных AI-задач.
Ranvik API работает в России без VPN: создайте аккаунт, пополните баланс и отправляйте запросы из своего приложения через единый API-ключ.
Да, в Ranvik API доступно пополнение баланса в рублях. Сервис поддерживает российские способы оплаты и расчет за фактическое использование.
Лучше использовать запись с чистым и разборчивым вокалом без лишних шумов. Чем понятнее исходная партия, тем точнее подбирается сопровождение.