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_custom | true для собственного текста, стиля и названия. По умолчанию false. |
version | Версия Suno из каталога моделей. |
title | Название трека, до 80 символов. Обязательно в кастомном режиме. |
tags | Описание стиля. Обязательно в кастомном режиме. Для v6 и v6 mini — до 1000 символов. |
instrumental | Для инструментала без текста передайте is_custom: true, instrumental: true, title и tags. Поле prompt опустите. |
vocal_gender | f для женского или m для мужского вокала в кастомном режиме. |
voice_id | ID своего сохранённого голоса 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. Подробнее в разделе Получение задачи.