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

Suno V5

suno-v5

Suno V5 — генерация аудио от Suno, доступная через единый Ranvik API.

от 28 ₽ / запрос

Карточка модели

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

МодальностьГенерация аудио

Провайдерsuno

СтатусАктивна

ID для запросовsuno-v5

Цены

Единица	Цена
за запрос	28 ₽
за запрос	28 ₽

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

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

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

Параметр	Тип	Диапазон / values	Default	Описание
`customMode`required	boolean	—	—	true — даёшь свой текст и стиль; false — Suno сам пишет.
`instrumental`required	boolean	—	—	true — без вокала.
`callBackUrl`required	string	—	—	URL для async-уведомления о готовности.
`prompt`	string	—	—	customMode=true: лирика (V4: до 3000, V4_5+: до 5000); customMode=false: описание (до 500). Required если customMode=false ИЛИ (customMode=true И instrumental=false).
`style`	string	—	—	customMode=true: жанр (V4: 200, V4_5+: 1000). Required при customMode=true.
`title`	string	—	—	customMode=true: название (V4/V4_5ALL: 80, V4_5+: 100). Required при customMode=true.
`negativeTags`	string	—	—	Что исключить из стиля (через запятую).
`vocalGender`	enum	m, f	—	Пол вокала.
`styleWeight`	number	min: 0 · max: 1	—	Сила следования стилю (0.00-1.00).
`weirdnessConstraint`	number	min: 0 · max: 1	—	Креативное отклонение.
`audioWeight`	number	min: 0 · max: 1	—	Влияние входного аудио.
`personaId`	string	—	—	Persona ID (custom mode only).
`personaModel`	enum	style_persona, voice_persona	style_persona	—

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

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

Sync (HTTP 200)

Для TTS короткого input: HTTP 200, **binary audio** (Content-Type: audio/mpeg / audio/wav / ...). Это НЕ JSON — это байты файла.

Binary response. Content-Type: audio/mpeg, audio/wav, audio/opus, audio/ogg

Async (HTTP 202)

Если is_async_only=1 (music gen) или async:true в запросе. HTTP 202 + JSON.

Поле	Тип	Значения	Описание
`id`	string	—	task_id для GET /v1/tasks/{id}.
`object`	string	audio.task
`status`	enum	queued, processing, completed, failed
`model`	string	—
`created`	integer	—

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

GET /v1/tasks/{id}.

Поле	Тип	Значения	Описание
`id`	string	—
`status`	enum	queued, processing, completed, failed, canceled
`modality`	string	audio
`model`	string	—
`data`	array	—	Каждый элемент: `url`— string · CDN URL .mp3 / .wav. Для Suno music — 1-2 файла (варианты трека).
`error`	string	—

Пример запроса

from openai import OpenAI

client = OpenAI(api_key="rk_live_...", base_url="https://api.ranvik.ru/v1")
resp = client.audio.speech.create(
    model= "suno-v5",
    customMode= False,
    instrumental= False,
    callBackUrl= "https://example.com/...",
    prompt= "Пример промпта",
    style= "value",
    title= "value",
    negativeTags= "value",
    vocalGender= "m",
    styleWeight= 0.5,
    weirdnessConstraint= 0.5,
    audioWeight= 0.5,
    personaId= "value",
    personaModel= "style_persona",
)
print(resp)

Замените rk_live_... на ваш ключ из кабинета.

О провайдере: Suno

Suno — генерация полноценных музыкальных треков по текстовому описанию или лирике. Поддерживает разные стили, инструменты и вокал.

Официальный сайт: https://suno.com

Документация модели у вендора: https://docs.sunoapi.org/