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

Suno Upload Cover API

ПровайдерSuno

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

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

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

Что умеет Suno Upload Cover

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

Стоимость

за запрос
13.21 ₽

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

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

Vendor
suno
Modality
audio

Suno Upload Cover API для создания музыкальных каверов

Suno Upload Cover — модель провайдера Suno для преобразования загруженного аудио в музыкальный кавер с новым звучанием. Она помогает переосмыслить набросок, демо или готовый трек, задавая стиль, текст, название, вокальное исполнение и режим инструментальной версии. В API доступны версии V5_5, V5, V4_5PLUS, V4_5ALL и V4, а также параметры влияния стиля, оригинальности и исходного аудио.

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

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

ПараметрТипДиапазон / значенияПо умолчаниюОписание
uploadUrlreq
string
—
—
URL аудио (≤8 мин; V4_5ALL: 1 мин).
customModereq
boolean
—
—
instrumentalreq
boolean
—
—
modelreq
enum
V4, V4_5, V4_5PLUS, V4_5ALL, V5, V5_5
—
callBackUrlreq
string
—
—
prompt
string
—
—
Required если customMode=false ИЛИ (customMode=true И instrumental=false).
style
string
—
—
Required при customMode=true.
title
string
—
—
Required при customMode=true.
negativeTags
string
—
—
vocalGender
enum
m, f
—
styleWeight
number
min: 0 · max: 1
—
weirdnessConstraint
number
min: 0 · max: 1
—
audioWeight
number
min: 0 · max: 1
—
personaId
string
—
—
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-upload-cover_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= "V4",
    uploadUrl= "https://example.com/...",
    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 Upload Cover

Suno Upload Cover — API-модель Suno для создания музыкальных каверов на основе загруженного аудио. Она позволяет задать новое настроение, стиль и вокальную подачу.
Модель пригодится для творческой переработки демо, эскизов и готовых треков. С ее помощью можно быстро получить новую интерпретацию исходной музыкальной идеи.
Подключить Suno Upload Cover можно через Ranvik API: сервис объединяет модели в одном интерфейсе и помогает начать работу с API без сложной интеграции.
В Ranvik API можно работать с Suno Upload Cover из России без VPN: получите ключ, передайте ссылку на аудио и параметры генерации в API-запросе.
Да, Ranvik API поддерживает оплату в российских рублях. Это упрощает пополнение баланса и делает доступ к Suno Upload Cover удобнее для российских команд.
В запросе можно указать ссылку на аудио, режим генерации, стиль, текст, название, инструментальный вариант и настройки влияния стиля или исходного трека.