Песня на русском без акцента: как подключить Suno API из России
Suno V6 работает по API под одним ключом CyHUB, оплата в рублях: песня по описанию или со своим текстом, кавер, продолжение, вокал на вашу музыку. Русский текст песни пишите кириллицей: на транслите в моих прогонах вокал пел с заметным акцентом.
Первая песня одним запросом
Ключ создаётся в кабинете CyHUB после подтверждения почты. Как войти, создать ключ и пополнить баланс, по шагам со скриншотами - в гайде по API.
Проще всего начать с простого режима: описываете песню словами, а слова, стиль и название модель придумает сама.
Через пять-десять минут у задачи статус succeeded, а в result лежат две версии трека в MP3 и текстом название со словами. Статус спрашиваете запросом GET /v1/tasks/{id}, файлы хранятся 7 дней. Цену тех же настроек заранее покажет POST /v1/price, ничего не списывая.
Ну а код можно отдать ИИ-агенту. Дайте Cursor, Claude Code или Codex ссылку api.cyhub.ai/models/suno/api.md - там все восемь режимов с параметрами и примерами.
Песня со своим текстом
Расширенный режим включает "customMode": true. Название title и стиль style в нём обязательны, текст песни prompt - если она не инструментальная.
Голос vocalGender, длительность duration от 10 до 360 секунд и два ползунка от 0 до 1 работают только в этом же режиме: styleWeight держит заданный стиль, а weirdnessConstraint отвечает за смелость звучания.
Куплеты и припев в prompt можно подписывать, как в примере: «Куплет 1», «Припев».
V6, V6 Mini или V6 Wild
Версию задаёт поле model: V6 стоит по умолчанию, V6_MINI - быстрая версия, V6_WILD - смелое, необычное звучание.
В моих прогонах V6 и V6 Wild держали заказанную длительность почти точно, а V6 Mini каждый раз отдавала трек короче. Если же длина важна - например, песня под хронометраж ролика, - берите V6.
Своё аудио: кавер, продолжение, вокал
Шесть режимов из восьми работают с вашим треком. Его передаёте ссылкой в поле audio: MP3, WAV, OGG, M4A, FLAC или AAC до 20 МБ.
• cover_upload - кавер: мелодия остаётся, стиль меняется. Поля те же, что у песни с нуля, в простом и расширенном режиме.
• extend - продолжение с секунды continueAt, она должна быть раньше конца трека.
• add_vocals - вокал поверх вашей музыки без голоса. Нужны название, стиль, текст и negativeTags: каких стилей в результате быть не должно.
• add_instrumental - музыка под ваш вокал без аккомпанемента, стиль задаёт поле tags.
• replace_upload - переписать кусок от infillStartS до infillEndS: не короче 10 секунд и не длиннее половины трека.
• mashup - ремикс двух треков. Второй идёт в поле audio2, первый задаёт основу.
Вот так, например, выглядит инструментальное продолжение трека с полуторной минуты:
Обрабатываются только свои записи: известные чужие песни Suno узнаёт и отказывается с ними работать. Для кавера и продолжения трек должен быть не длиннее 8 минут.
Звук или фон
Для игр и роликов есть режим sounds: не песня, а звук - шум дождя, гул города, эффект. Описание идёт в soundDescription, по желанию можно зациклить звук (soundLoop), задать темп (soundTempo) и тональность (soundKey). Приходят короткие куски, готовы они примерно за минуту.
Что ломается
• 422 unknown_setting - в settings поле, которого у режима нет. У каждого режима свой набор полей, сверяйтесь со страницей модели.
• Отказ на загруженном треке - Suno узнал известную песню. Подойдёт только своя запись.
• Ссылка на аудио не принимается - ссылка ведь должна отдавать сам файл, а не страницу просмотра. Своего хостинга нет - загрузите файл через POST /v1/files и подставьте url из ответа.
• add_vocals не принимается - проверьте negativeTags: в этом режиме поле обязательное.
Песни без кода, прямо в чате
Частые вопросы
Нужен ли аккаунт Suno? Нет, хватает ключа CyHUB: запросы к Suno идут через него.
Почему приходит два трека? Suno за один запуск делает две версии песни. Цена ведь за запуск, а не за каждый трек: выбираете лучшую.
Спишутся ли деньги, если генерация упала? Нет. При приёме задачи цена резервируется, а списывается только после статуса succeeded. Ошибка - и резерв вернётся на баланс.
Все режимы Suno, документация и остальные модели - в каталоге CyHUB. А вам песни по API для чего: джинглы, музыка к роликам, игра или своё приложение?