Перейти к содержимому

Suno

Создавайте музыку через POST /api/v2/media/tasks с model: "suno". Нужен API-ключ GPTunneL.

Генерация Suno через этот метод принимает текст. Для проверки запроса и стоимости передайте то же тело в расчёт цены.

Простой режим

Опишите звучание в prompt длиной до 500 символов. Для собственного названия, стиля в отдельном поле и текста песни включите кастомный режим.

Окно терминала
curl 'https://gptunnel.ru/api/v2/media/tasks' \
-H 'Authorization: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"model": "suno",
"prompt": "Спокойный lo-fi трек с мягким пианино и лёгкими ударными"
}'

Кастомный режим

Передайте текст песни в prompt, название в params.title и описание звучания в params.tags.

Окно терминала
curl 'https://gptunnel.ru/api/v2/media/tasks' \
-H 'Authorization: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"model": "suno",
"prompt": "[Verse]\nMorning lights along the shore\nWaves are rolling in once more\nWe count the boats against the blue\nAnd wait to watch the sky turn new",
"params": {
"is_custom": true,
"version": "chirp-v6",
"title": "Along the Shore",
"tags": "Indie pop, acoustic guitar, soft drums, 95 BPM",
"vocal_gender": "f"
}
}'
ПараметрЧто передать
is_customtrue для собственного текста, стиля и названия. По умолчанию false.
versionВерсия Suno из каталога моделей.
titleНазвание трека, до 80 символов. Обязательно в кастомном режиме.
tagsОписание стиля. Обязательно в кастомном режиме. Для v6 и v6 mini — до 1000 символов.
instrumentalДля инструментала без текста передайте is_custom: true, instrumental: true, title и tags. Поле prompt опустите.
vocal_genderf для женского или m для мужского вокала в кастомном режиме.
voice_idID своего сохранённого голоса Suno.

Снятые ключи версий Suno автоматически преобразуются в актуальные. В ответе params.version будет применённая версия.

Для v6 и v6 mini текст песни может содержать до 5000 символов. Длины считаются в единицах UTF-16, как String.length в JavaScript. Например, 🎵 занимает две единицы.

Для кастомного инструментала передайте такое тело:

{
"model": "suno",
"params": {
"is_custom": true,
"instrumental": true,
"title": "У берега",
"tags": "Акустическая гитара, мягкие ударные, 95 BPM"
}
}

Поле prompt_optional_when в карточке Suno описывает это сочетание. При неверном значении известного параметра API возвращает HTTP 400 с именем поля в details. Неизвестные имена попадают в ignored_params.

Сохранённый голос

Окно терминала
curl 'https://gptunnel.ru/api/v2/media/voices?model=suno' \
-H 'Authorization: YOUR_API_KEY'

Из ответа возьмите voices[].id и передайте в params.voice_id. Выберите chirp-v6 и опустите vocal_gender. Для песни со своим текстом передайте голос вместе с is_custom: true, названием и стилем. Для инструментала выбирайте голос, у которого в каталоге указано supports_instrumental: true. Каталог отдаёт готовые голоса Suno владельца ключа. Создать голос можно в музыкальном инструменте GPTunneL. Для автоматического выбора вокала опустите voice_id.

Если голос отсутствует в библиотеке владельца или несовместим с выбранной версией, API вернёт HTTP 400 до создания задачи и списания. Провайдер также может отклонить ранее сохранённый голос во время генерации. После получения id проверьте итоговый статус через GET /api/v2/media/tasks/{id}.

Результат

Чтобы безопасно повторить создание после таймаута, укажите idempotency_key в первом запросе к /tasks и повторите его с тем же телом и ключом. Из ответа на создание возьмите id и подставьте вместо TASK_ID.

Окно терминала
curl 'https://gptunnel.ru/api/v2/media/tasks/TASK_ID' \
-H 'Authorization: YOUR_API_KEY'

Когда статус станет done, ссылки на обе дорожки будут в result[].url. Подробнее в разделе Получение задачи.