ГлавнаяМоделиГенерация аудиоSuno V5

Suno V5 API

ПровайдерSuno

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

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

Suno V5 Открыть в песочнице

Что умеет Suno V5

Базовый набор возможностей модели — см. документацию вендора.

Стоимость

за запрос
13.21 ₽

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

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

Vendor
suno
Modality
audio

Suno V5 для генерации музыки

Suno V5 — музыкальная модель провайдера Suno, выпущенная 23 сентября 2025 года. Она создает композиции с более чистым и объемным звучанием, естественными вокальными партиями и точнее понимает жанры и их сочетания. Модель также поддерживает ремастеринг ранее созданных треков, позволяя менять степень отличия от оригинала.

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

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

ПараметрТипДиапазон / значенияПо умолчаниюОписание
customModereq
boolean
—
—
true — даёшь свой текст и стиль; false — Suno сам пишет.
instrumentalreq
boolean
—
—
true — без вокала.
callBackUrlreq
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
—

Пример кода

suno-v5_example.py
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)
Полная документация модели

Частые вопросы о Suno V5

Suno V5 — модель для генерации музыки по текстовому описанию. Она помогает создавать треки с естественным вокалом, чистым звуком и жанровым характером.
Suno V5 пригодится для быстрых музыкальных идей, демо, контента и творческих экспериментов. Ranvik API упрощает подключение модели к вашим сценариям.
Подключить API Suno V5 можно через Ranvik API. Сервис предоставляет удобный доступ для интеграции генерации музыки в сайты, приложения и внутренние продукты.
Через Ranvik API можно работать с API Suno V5 в России без VPN. Зарегистрируйтесь, получите доступ и отправляйте запросы из своего приложения или сервиса.
Да, Ranvik API позволяет оплачивать использование API Suno V5 в российских рублях. Это делает подключение сервиса удобнее для команд и разработчиков из России.
Начните с регистрации в Ranvik API, затем получите ключ доступа и подключите запросы в проект. API поможет автоматизировать создание музыки в нужном сценарии.