Suno V5.5

ПровайдерSuno

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

asynctext_to_audio

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

Suno V5.5 Открыть в Playground

Что умеет Suno V5.5

Async
Text-to-Audio

Стоимость

за запрос

14 ₽

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

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

Vendor

suno

Modality

audio

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

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

ПараметрТипДиапазон / значенияПо умолчаниюОписание

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

—

Пример кода

v5_5_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= "v5_5",
    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)

Полная документация модели