Suno Upload Cover

ПровайдерSuno

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

Что умеет Suno Upload Cover

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

Стоимость

за запрос

28 ₽

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

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

Vendor

suno

Modality

audio

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

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

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

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)

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