Suno Add Instrumental API

ПровайдерSuno

suno-add-instrumental — генерация аудио-модель от Suno.

add_instrumentalasyncmusic

Попробуйте прямо здесь

Что умеет Suno Add Instrumental

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

Стоимость

за запрос
7.98 ₽

Цены указаны в рублях и списываются с баланса проекта за успешные запросы. Надбавки (+) суммируются с базовой ставкой.

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

Vendor
suno
Modality
audio

Suno Add Instrumental API для создания инструментальных аранжировок

Suno Add Instrumental — аудиомодель провайдера Suno для дополнения вокальной или акапельной записи инструментальной аранжировкой. Ее особенность — создание нового музыкального сопровождения вокруг исходной партии, что удобно для демо, ремиксов и альтернативных версий трека. В API-сценарии можно передать прямую публичную ссылку на аудио и получить результат после асинхронной обработки.

Параметры запроса

Параметры, которые принимает модель. Передаются в теле запроса.

ПараметрТипДиапазон / значенияПо умолчаниюОписание
uploadUrlreq
string
—
—
Прямая публичная HTTP(S)-ссылка на MP3/WAV без редиректов, до 32 МБ.
version
enum
V6, V6_WILD, V6_MINI
V6
Версия обработки: V6, экспериментальная V6_WILD или облегченная V6_MINI. Параметр model содержит ID инструмента Ranvik API.
titlereq
string
—
—
Название новой аранжировки.
tagsreq
string
—
—
Желаемые жанр, инструменты и настроение.
negativeTagsreq
string
—
—
Нежелательные особенности звучания.
lyrics
string
—
—
Необязательный текст песни.
vocalGender
enum
m, f
—
Предпочтительный вокал: мужской или женский.
styleWeight
number
min: 0 · max: 1
—
Следование стилю; до двух знаков после запятой.
weirdnessConstraint
number
min: 0 · max: 1
—
Экспериментальность; до двух знаков после запятой.
audioWeight
number
min: 0 · max: 1
—
Влияние исходного звучания; до двух знаков после запятой.
variety
integer
min: 0 · max: 4
—
Разнообразие вариантов, от 0 до 4.

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

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

Async (HTTP 202)

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

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

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

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

ПолеТипЗначенияОписание
data
array
—
Каждый элемент:
  • url— string
  • name— 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 доступно пополнение баланса в рублях. Сервис поддерживает российские способы оплаты и расчет за фактическое использование.
Лучше использовать запись с чистым и разборчивым вокалом без лишних шумов. Чем понятнее исходная партия, тем точнее подбирается сопровождение.