Suno API: официальный статус, ключи API и пример на Python

На 17 октября 2026 года у Suno есть официальный API, но записаться на него нельзя: на platform.suno.com только вход для тех, у кого аккаунт API уже есть, без публичной документации, цен и самостоятельной регистрации, а в июле Suno сообщила, что начинает с ограниченного круга партнёров. Без приглашения сегодня работают два других варианта.

Есть ли у Suno официальный API?

Suno предлагает API на platform.suno.com, и эта единственная страница — вся его публичная витрина.

В заголовке обещаны «original songs, covers, and mashups from a single prompt» за «a simple REST API», а единственное действие на странице — вход через аккаунт Google, привязанный к аккаунту Suno, или по коду из письма. Остальные ссылки — suno.com, Terms и Privacy, и больше ничего; /docs и /pricing на том же домене показывают ту же форму входа (проверено 17 октября 2026 года). То есть API существует, но документация и цены видны только после входа.

О наборе партнёров известно из Music Business Worldwide: 2 июля 2026 года издание сообщило, что директор по продукту Suno Джек Броуди (Jack Brody) объявил о планах в посте в LinkedIn 1 июля и дал ссылку на форму заявки. В форме, как цитирует её материал, сказано: «We're beginning to explore a developer API, starting with a curated group of partners.» Иначе говоря, Suno начинает изучать API для разработчиков с ограниченного круга партнёров. Дату запуска не объявили, и ни страница платформы, ни список изменений, ни справочный центр её не добавляют.

Для крупных клиентов путь идёт через отдел продаж: в Условиях Suno сказано «if you are an enterprise user, you must contact sales to use our Service». Тот же материал отмечает, что Suno «has not released self-serve developer access or published its own API documentation», и это совпадает с тем, что страница показывает в октябре.

Три способа вызывать Suno из кода сегодня

Официальный партнёрский доступ. Форма, на которую Броуди дал ссылку в июле, — единственная дверь, которую Suno показала, и материал описывает ранний доступ для ограниченного круга партнёров, а не открытую регистрацию. На 17 октября 2026 года на странице платформы только форма входа, без анкеты, листа ожидания и ссылки на запрос доступа, а публичной ссылки на эту форму на страницах самой Suno мы не нашли. Music Business Worldwide не сообщило сроков более широкого запуска.

Неофициальная обёртка с GitHub. gcui-art/suno-api — самый известный обходной путь: 3 259 звёзд и около 100 открытых issues на 17 октября 2026 года, последний коммит 6 марта 2026 года. В README сказано, что официальный API «is not yet available», и запрошены три вещи: cookie вашего собственного аккаунта Suno, скопированный вручную из вкладки сети в браузере; платный ключ 2Captcha, потому что Suno продолжает показывать капчу hCaptcha; и настоящий браузер под управлением Playwright с патчами rebrowser. В issue #262, открытом 14 декабря 2025 года, автор пишет, что ему «lacks the time to maintain it».

Условия обслуживания Suno, последняя редакция 10 августа 2026 года, вступление в силу 3 сентября 2026 года, запрещают «any data mining, robots, scraping, or similar data gathering or extraction methods», а также получение контента «through any means not intentionally made available or provided for through the Service». Прочитайте оба пункта в Условиях Suno до того, как строить продукт на обёртке, которая управляет suno.com вашим cookie. В самом README предупреждения нет: единственная юридическая строка там — лицензия LGPL-3.0.

Сторонняя API-платформа. OmniaKey — сторонняя API-платформа, а не Suno. Она продаёт доступ по API к Suno v4.5 и Suno v6 через собственный асинхронный media API, ключ выдаёт и оплату считает OmniaKey. В документации ровно два ID моделей, suno-v4.5 и suno-v6, и каждый запрос возвращает одну готовую сведённую песню, тогда как аккаунт Suno показывает два варианта. Этот вариант мы и прогнали от начала до конца ниже.

Генерация песни на Python

Один запрос создаёт задачу, второй вызов проверяет статус, готовый MP3 приходит подписанной ссылкой. Выгрузите ключ в переменную окружения, сохраните скрипт как suno_song.py и запустите: скрипт опрашивает status каждые 5 секунд, потому что progress.percent приблизителен и может стоять на 0, пока задача выполняется.

export OMNIAKEY_API_KEY="your-key"
python3 suno_song.py

import os
import time
import uuid

import requests

API = "https://api.omniakey.com/v1/media/tasks"
HEADERS = {"Authorization": f"Bearer {os.environ['OMNIAKEY_API_KEY']}"}

# 1. Create the job. Reuse the same Idempotency-Key only when retrying this exact request.
job = requests.post(
    API,
    headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())},
    json={
        "model": "suno-v4.5",
        "type": "audio",
        "operation": "generate",
        "input": {"prompt": "calm lo-fi beat for late-night coding, soft piano, vinyl crackle"},
        "parameters": {"title": "Late Build", "instrumental": True},
    },
    timeout=30,
)
job.raise_for_status()
task = job.json()
print("task:", task["id"], task["status"])

# 2. Poll on status, not on progress.percent, until the job finishes.
while task["status"] in ("queued", "processing"):
    time.sleep(5)
    task = requests.get(f"{API}/{task['id']}", headers=HEADERS, timeout=30).json()

if task["status"] != "succeeded":
    raise SystemExit(f"job ended {task['status']}: {task.get('error')}")

# 3. Download the MP3 now: the signed URL expires in about an hour.
asset = task["assets"][0]
with open("late-build.mp3", "wb") as f:
    f.write(requests.get(asset["url"], timeout=120).content)
print("saved late-build.mp3", asset["byte_size"], "bytes")

Тот же скрипт мы запустили 17 октября 2026 года, и он вывел две строки:

task: task_VDvzdpfABcqDOIpo9I1p7CXHg99elSuK queued
saved late-build.mp3 3506516 bytes

От запуска до сохранённого файла прошло 82 секунды. Файл — стерео MP3 48 кГц, около 161 кбит/с, длительность 2:55, размер 3,5 МБ, без вокала, потому что в скрипте instrumental стоит true.

Чтобы сравнить обе модели в двух режимах ввода, мы 17 октября 2026 года с 13:03 UTC сделали ещё четыре песни через API OmniaKey, опрашивая статус каждые 4 секунды.

Все четыре завершились с первой попытки, и каждый запрос вернул один MP3. Описание дало полноценную песню примерно на три минуты; тот же стиль с восемью строками своего текста вернулся за 45–63 секунды, так что при своём тексте рассчитывайте на короткий трек. Битрейт — от 151 до 195 кбит/с при 48 кГц стерео, а подписанные ссылки на скачивание истекали примерно через час после создания задачи.

Параметры и ограничения

• Непустой input.lyrics включает режим своего текста, и тогда input.prompt, parameters.style или parameters.tags описывают стиль; задача без prompt и без текста отклоняется.
• suno-v6 выбирается по ID модели и не требует mv, а mv действует только для v4.5.
• Доступна только generate. Продление, отдельный текст и синтез речи падают с 503 no_available_channel, а предоплата возвращается.
• Один запрос — одна готовая песня, поэтому parameters.n должно быть 1.
• Ссылки на файлы подписанные и недолгие, около часа, а записи задач хранятся 24 часа после создания.

Ошибки и возвраты

Задача, которая упала, отменена или не дошла до провайдера, возвращается автоматически, а отменённая задача, которая всё же завершилась, оплачивается по тому состоянию, в котором она закончилась. Повтор того же ключа идемпотентности с тем же телом возвращает исходную задачу с кодом 200 вместо второй задачи, поэтому повтор после таймаута списывает деньги один раз. Восстановление короткое: если создание закончилось таймаутом, отправьте то же тело и тот же ключ ещё раз; получив ID задачи, просто продолжайте её опрашивать.

Частые вопросы

Есть ли бесплатный Suno API?

Suno не публикует бесплатного тарифа API на platform.suno.com. Бесплатные тарифы живут в приложении suno.com: v6-mini открыт всем, а вариант v4.5-all бесплатен с 21 октября 2025 года. Результат на бесплатном тарифе — только для личного, некоммерческого использования.

Можно ли использовать песни из Suno API в коммерческих целях?

Условия Suno передают Output подписчикам Pro и Premier и разрешают коммерческое использование только для Output, «downloaded by you through an approved channel», то есть скачанного вами через одобренный канал. Output с бесплатного тарифа остаётся некоммерческим, а ремиксы — только для личного использования при любом тарифе. Песни из стороннего API здесь не исключение, поэтому прочитайте Условия Suno, прежде чем класть сгенерированную песню в платный продукт.

Сколько времени занимает одна песня?

Документация по аудио указывает от двадцати секунд до двух минут на генерацию. Наши четыре задачи заняли от 70 до 105 секунд, а запуск скрипта — 82 секунды от старта до сохранённого файла.

Что выбрать, v4.5 или v6?

Suno представила семейство v6 9 сентября 2026 года, а v4.5 — 1 мая 2025 года. v6 выбирается только по ID модели, а v4.5 принимает parameters.mv, чтобы зафиксировать версию, и ID suno-v4.5 у OmniaKey не говорит, на какой именно вариант v4.5 он указывает. Suno называет v6 флагманской моделью, поэтому начните с Suno v6, если только вам не нужно закрепить старую версию v4.5.

Как получить ключ Suno API?

Если аккаунт API уже есть, войдите на platform.suno.com через аккаунт Google, привязанный к аккаунту Suno, или по коду из письма. Без аккаунта единственной публичной дверью была июльская форма для партнёров, и на странице её сейчас нет. Сторонняя платформа вроде OmniaKey выдаёт свой ключ, отдельный от любого входа в Suno.