Перейти к основному содержанию
POST

Authorizations

Authorization
string
обязательно
Все эндпоинты требуют аутентификации с использованием Bearer TokenПолучить API Key:Перейдите на страницу управления API Key, чтобы получить ваш API KeyПри использовании добавьте в заголовки запроса:

Body

model
string
по умолчанию:"suno"
Аудиомодель. Сейчас передавайте suno (если не указано, по умолчанию suno).
audio_urls
array
обязательно
Массив из 1–4 публично доступных URL аудио.
version
string
по умолчанию:"v5.5"
Версия генерации: v4 / v4.5 / v4.5+ / v4.5-all / v5 / v5.5, влияет на качество звука и тарификацию; если не указано, по умолчанию v5.5.
prompt
string
Текст песни / содержание.
title
string
Заголовок.
tags
string
Теги стиля.
negative_tags
string
Исключаемые теги стиля.
style_weight
number
Вес стиля, 0.001.00.
weirdness_constraint
number
Вес креативности, 0.001.00 (псевдоним weirdness).
audio_weight
number
Вес аудио, 0.001.00.
vocal_gender
string
Пол вокала: Male / Female.
auto_lyrics
boolean
true = творчески переработать переданный текст песни.
Получение результата: этот эндпоинт является асинхронной задачей. После отправки вы получаете task_id; опрашивайте GET /v1/music/tasks/{task_id} с интервалом 3–5 с, пока status не станет completed или failed (генерация музыки обычно занимает 30–120 с; во время генерации status равен pending, а progress меняется: в очереди 10 → готово 50 → завершено 100). По завершении возьмите audio_url из data.result.music[]. При неудаче data.error.message содержит причину, а предварительно списанная квота автоматически возвращается.

Response

code
integer
Код статуса ответа
data
array
Массив возвращаемых данных