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

Suno Extend API

ПровайдерSuno

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

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

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

Что умеет Suno Extend

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

Стоимость

за запрос
10.56 ₽

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

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

Vendor
suno
Modality
audio

Suno Extend: API для продолжения музыкальных треков

Suno Extend — инструмент провайдера Suno, американской музыкальной компании, для естественного продолжения готовых треков. Он позволяет выбрать точку в аудио, задать новый текст, жанр или детали звучания и сгенерировать следующую музыкальную часть. Это удобно для доработки финала, развития куплета, добавления припева и создания цельной композиции без повторной генерации с нуля.

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

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

ПараметрТипДиапазон / значенияПо умолчаниюОписание
audioIdreq
string
—
—
ID существующего трека.
defaultParamFlagreq
boolean
—
—
true — игнорирует prompt/style/title и продлевает в стиле оригинала. false — требует все эти поля.
callBackUrlreq
string
—
—
modelreq
enum
V3_5, V4, V4_5, V4_5PLUS, V4_5ALL, V5, V5_5
V4_5
prompt
string
—
—
Required при defaultParamFlag=true.
style
string
—
—
Required при defaultParamFlag=true.
title
string
—
—
Required при defaultParamFlag=true.
continueAt
number
min: 0
—
С какой секунды продлить. Required при defaultParamFlag=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-extend_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_5",
    audioId= "value",
    defaultParamFlag= False,
    callBackUrl= "https://example.com/...",
    prompt= "Пример промпта",
    style= "value",
    title= "value",
    continueAt= 0,
    negativeTags= "value",
    vocalGender= "m",
    styleWeight= 0.5,
    weirdnessConstraint= 0.5,
    audioWeight= 0.5,
    personaId= "value",
    personaModel= "style_persona",
)
print(resp)
Полная документация модели

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

Suno Extend — инструмент для продолжения созданного или загруженного трека с выбранного момента. Он помогает развивать композицию по текстовому запросу.
Функция нужна, чтобы дописать куплет, припев или финал, изменить развитие аранжировки и сохранить музыкальную идею без генерации трека заново.
Подключить API можно через Ranvik API: зарегистрируйтесь, создайте ключ в личном кабинете и используйте его в приложении, сервисе или сценарии автоматизации.
В Ranvik API доступ к инструментам генерации музыки работает в России без VPN. Достаточно получить API-ключ, пополнить баланс и отправлять запросы.
Да, Ranvik API поддерживает оплату в российских рублях и модель pay-as-you-go. Вы пополняете баланс и оплачиваете только фактически использованные ресурсы.
Обычно указывают идентификатор исходного аудио, точку продолжения, текст или описание стиля. Ranvik API помогает встроить этот процесс в ваш продукт.