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

Suno Stem Separation

suno-stem-separation

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

от 6.65 ₽ / запрос

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

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

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

Возможности

  • Async
  • Генерация музыки
  • Разделение на дорожки

Цены

ЕдиницаЦена
за запрос · Вокал и инструментал6.65 ₽
за запрос · Выбранный инструмент13.3 ₽
за запрос · До 12 дорожек33.25 ₽

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

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

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

ПараметрТипДиапазон / valuesDefaultОписание
audioUrlrequiredstring—— Прямая публичная HTTP(S)-ссылка на MP3/WAV без редиректов, до 20 МБ.
typeenumseparate_vocal, split_stem, split_stem_advancedseparate_vocal Две дорожки, до 12 дорожек или выбранный инструмент. Стоимость зависит от режима.
stemNameenumLead 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 задачи, а не бинарный файл.

ПолеТипЗначенияОписание
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-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