Suno Stem Separation
suno-stem-separation
Suno Stem Separation — генерация аудио от Suno, доступная через единый Ranvik API. Поддерживаемые возможности: async, music, stem_separation.
от 6.65 ₽ / запрос
Разделение записи на вокал и инструментал, до 12 отдельных дорожек или выделение выбранного инструмента. Обработка асинхронная: создайте задачу, затем получите все файлы через GET /v1/tasks/{id}.
Технические характеристики
suno-stem-separationВозможности
- Async
- Генерация музыки
- Разделение на дорожки
Цены
| Единица | Цена |
|---|---|
| за запрос · Вокал и инструментал | 6.65 ₽ |
| за запрос · Выбранный инструмент | 13.3 ₽ |
| за запрос · До 12 дорожек | 33.25 ₽ |
Цены указаны в рублях. Списываются с баланса проекта при каждом успешном запросе.
Поддерживаемые параметры
Параметры передаются вендору как есть (pure proxy) — мы не валидируем их у себя на стороне. Если вендор не примет — вернётся его ошибка.
| Параметр | Тип | Диапазон / values | Default | Описание |
|---|---|---|---|---|
audioUrlrequired | string | — | — | Прямая публичная HTTP(S)-ссылка на MP3/WAV без редиректов, до 20 МБ. |
type | enum | separate_vocal, split_stem, split_stem_advanced | separate_vocal | Две дорожки, до 12 дорожек или выбранный инструмент. Стоимость зависит от режима. |
stemName | enum | Lead Vocal, Drum Kit, Kick, Snare, Risers, Bass, Backing Vocals, Piano, Electric Guitar, Percussion, String Section, Synth, Acoustic Guitar, Sound Effects, Synth Pad, Synth Bass, Guitar, Brass Section, Organ, Electronic Drum Kit, Lead Electric Guitar, Synth Keys, Rhythm Electric Guitar, Electric Piano, Upright Bass, Keyboards, Distorted Electric Guitar, Synth Strings, Synth Lead, Woodwinds, Rhythm Acoustic Guitar, Flute, Harp, Tambourine, Trumpet, Arpeggiator, Accordion, Fiddle, Pedal Steel Guitar, Synth Voice, Violin, Digital Piano, Synth Brass, Mandolin, Choir, Banjo, Bells, Clarinet, Tenor Saxophone, Trombone, Shaker, French Horn, Glockenspiel, Electric Bass, Cello, Timpani, Harmonica, Marimba, Vibraphone, Lap Steel Guitar, Saxophone, Orchestra, Horns, Cymbals, Hand Clap, Oboe, Celesta, Congas, Drone, Alto Saxophone, Double Bass, Ukulele, Harpsichord, Baritone Saxophone, Xylophone, Tuba, Bass Guitar, Whistle, Lead Guitar, Rhodes, 808, Bongos, Bassoon, Cowbell, Viola, Sitar, Steel Drums, Piccolo, Theremin, Bagpipes, Hi-Hat, Music Box, Melodica, Tabla, Koto, Djembe, Taiko, Didgeridoo | — | Выбранный инструмент. Передавайте только при type=split_stem_advanced; возвращаются выделенная партия и версия без нее. |
Параметры ответа
Что возвращает 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-stem-separation",
"audioUrl": "https://example.com/track.mp3",
"type": "separate_vocal"
},
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