Suno Extend

suno-extend

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

от 22.4 ₽ / запрос

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

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

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

Провайдерsuno

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

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

Цены

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

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

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

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

Параметр	Тип	Диапазон / values	Default	Описание
`audioId`required	string	—	—	ID существующего трека.
`defaultParamFlag`required	boolean	—	—	true — игнорирует prompt/style/title и продлевает в стиле оригинала. false — требует все эти поля.
`callBackUrl`required	string	—	—	—
`model`required	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	—

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

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)

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

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

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

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

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