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-add-instrumentalВозможности
- Добавление аккомпанемента
- Async
- Генерация музыки
Цены
| Единица | Цена |
|---|---|
| за запрос | 7.98 ₽ |
Цены указаны в рублях. Списываются с баланса проекта при каждом успешном запросе.
Поддерживаемые параметры
Параметры передаются вендору как есть (pure proxy) — мы не валидируем их у себя на стороне. Если вендор не примет — вернётся его ошибка.
| Параметр | Тип | Диапазон / values | Default | Описание |
|---|---|---|---|---|
uploadUrlrequired | string | — | — | Прямая публичная HTTP(S)-ссылка на MP3/WAV без редиректов, до 32 МБ. |
version | enum | V6, V6_WILD, V6_MINI | V6 | Версия обработки: V6, экспериментальная V6_WILD или облегченная V6_MINI. Параметр model содержит ID инструмента Ranvik API. |
titlerequired | string | — | — | Название новой аранжировки. |
tagsrequired | string | — | — | Желаемые жанр, инструменты и настроение. |
negativeTagsrequired | 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 | — | Каждый элемент:
|
Пример запроса
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