Что такое Suno API?
Suno не предоставляет публичный API. На suno.com нет консоли разработчика, страницы API key или официального способа генерировать музыку программно.
Sunor предоставляет неофициальный Suno AI API — REST-обёртку над моделями генерации музыки Suno. Стандартный API-доступ с key-аутентификацией, асинхронной обработкой task и автоматическим списанием. Аккаунт Suno не нужен.
Сейчас API работает на Suno V5.5 (последняя модель) и поддерживает генерацию музыки, генерацию текстов, загрузку аудио и продление треков.
Как использовать Suno API
От нуля до сгенерированной музыки в три шага.
Создайте аккаунт
Перейдите на sunor.cc/login и войдите через Google. Без email-форм и листов ожидания.
Получите API key
В dashboard перейдите в API Keys и создайте новый key. Скопируйте его сразу — key (формат: sk_live_...) показывается только один раз. Подробное руководство — How to Get a Suno API Key.
Сделайте первый API-вызов
Отправьте POST-запрос для создания task на генерацию музыки. Опрашивайте результат. Когда status станет "success" — скачайте аудио.
Реальные клиенты, создающие на Sunor
Эти рабочие процессы составляют большую часть трафика sunor сегодня. Каждый из них нацелен на свой случай использования Suno API разработчиками.
Платформы персонализированных песен
Создавайте B2C-маркетплейсы, где клиенты заказывают индивидуальные песни в качестве подарков и сувениров на события — дни рождения, годовщины, свадьбы, День матери, выход на пенсию, мемориальные посвящения. Custom Mode Suno V5 встраивает данные пользователя (имя получателя, историю, повод, язык — V5 поддерживает 35+) напрямую в текст песни; теги голоса формируют вокальный стиль. Автоматический возврат при сбое позволяет назначать клиентам фиксированную цену за песню с предсказуемой маржой.
{
"model": "suno",
"task_type": "music",
"input": {
"prompt": "[Female Voice]\n[Verse 1]\nHappy birthday, dear Anna,\n50 years of stories shared...\n[Chorus]\nYou're the light of our family...",
"tags": "pop, joyful, acoustic"
}
}Маркетинг и брендовое аудио
Агентства и команды брендов, генерирующие джинглы, звуковую айдентику, рекламную музыку и треки для соцкампаний. Быстрая итерация без лицензионных сборов или планирования сессионных музыкантов. PAYG-кредиты масштабируются с объёмом проекта — нет ежемесячной подписки для поглощения в медленные месяцы, нет квоты для планирования во время спринта запуска.
{
"model": "suno",
"task_type": "music",
"input": {
"gpt_description_prompt": "Energetic 30-second jingle for a sneaker brand, electronic synth, motivational",
"make_instrumental": true
}
}Видео и мультимедийные инструменты
Добавляйте сгенерированные на заказ саундтреки в видеоредакторы, инструменты для влогов, платформы для контента в соцсетях и рабочие процессы стоковых материалов. Флаг make_instrumental создаёт фоновую музыку без вокала, подходящую для контента с озвучкой; управление стилем через теги ('cinematic, ambient' или 'upbeat, electronic') делает генерацию музыки для каждой сцены возможной без лицензирования музыкальной библиотеки.
{
"model": "suno",
"task_type": "music",
"input": {
"gpt_description_prompt": "Cinematic ambient pad for a 30-second product reveal — slow build, hopeful, no vocals",
"make_instrumental": true,
"tags": "cinematic, ambient, hopeful"
}
}Разработка игр и интерактивные медиа
Генерируйте динамический OST, ambient-слои и модульные треки для игр, интерактивных проектов и middleware игрового аудио. Инструментальный режим + управление настроением через теги поддерживает scoring по уровням или областям. Предварительно генерируйте музыкальную библиотеку во время сборки или вызывайте API во время выполнения для музыки, управляемой состоянием игрока.
{
"model": "suno",
"task_type": "music",
"input": {
"gpt_description_prompt": "Looping dungeon exploration ambient — low strings, distant percussion, tense but explorable",
"make_instrumental": true,
"tags": "fantasy ost, ambient, looping"
}
}Рабочие процессы ИИ-агентов и инструменты для авторов
Подключите Sunor к конвейерам ИИ-агентов и инструментам для авторов песен, где тексты создаются в другом месте — LLM, пользовательским редактором текстов или автономным музыкальным агентом. Custom Mode принимает тексты напрямую с маркерами секций [Verse], [Chorus], [Bridge] и генерирует аудио, следующее структуре. Дизайн API подходит для программной музыки как части более крупного потока, а не для одноразовой генерации.
{
"model": "suno",
"task_type": "music",
"input": {
"prompt": "[Verse 1]\n<LLM-generated lyrics here>\n[Pre-Chorus]\n<more lyrics>\n[Chorus]\n<hook lyrics>",
"tags": "<genre, mood, style>"
}
}Примеры кода
Сгенерируйте трек одним API-вызовом. Все примеры используют один и тот же endpoint и аутентификацию.
curl -X POST https://sunor.cc/api/v1/task \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno",
"task_type": "music",
"input": {
"gpt_description_prompt": "An upbeat acoustic folk song about road trips",
"make_instrumental": false
}
}'import requests, time
API_KEY = "YOUR_API_KEY"
headers = {"x-api-key": API_KEY, "Content-Type": "application/json"}
# Create task
task = requests.post("https://sunor.cc/api/v1/task", headers=headers, json={
"model": "suno",
"task_type": "music",
"input": {"gpt_description_prompt": "An upbeat acoustic folk song about road trips"}
}).json()
# Poll until done
task_id = task["data"]["task_id"]
while True:
result = requests.get(f"https://sunor.cc/api/v1/task/{task_id}", headers=headers).json()
if result["data"]["status"] in ("success", "failure"):
break
time.sleep(5)
print(result["data"]["output"])const API_KEY = "YOUR_API_KEY";
const headers = { "x-api-key": API_KEY, "Content-Type": "application/json" };
// Create task
const task = await fetch("https://sunor.cc/api/v1/task", {
method: "POST",
headers,
body: JSON.stringify({
model: "suno",
task_type: "music",
input: { gpt_description_prompt: "An upbeat acoustic folk song about road trips" },
}),
}).then((r) => r.json());
// Poll until done
const taskId = task.data.task_id;
let result;
while (true) {
result = await fetch(`https://sunor.cc/api/v1/task/${taskId}`, { headers }).then((r) => r.json());
if (["success", "failure"].includes(result.data.status)) break;
await new Promise((r) => setTimeout(r, 5000));
}
console.log(result.data.output);Производственные паттерны
Polling с тайм-аутом и backoff
Большинство музыкальных задач завершаются за 3-7 минут. Опрашивайте каждые 5 секунд в первую минуту, затем каждые 10 секунд. Рассматривайте всё, что остаётся в ожидании после 15 минут, как мягкий сбой и предлагайте пользователю опцию повтора. У Sunor есть встроенный защитный тайм-аут как конечный fallback — вашему клиенту не нужно отслеживать собственный.
Обработка ошибок с учётом возврата
Неудачные задачи автоматически возвращают кредиты в ваш кошелёк в течение секунд. Ваш клиент должен рассматривать сбой с возможностью возврата как 'расходы не понесены, безопасно повторить с откорректированным промптом', а не как 'бюджет израсходован'. Проверяйте status === 'failure' или 'timeout' и повторно отправляйте с backoff.
Ограничение скорости + параллелизм
По умолчанию 120 запросов в минуту на ключ API. Для высокообъёмных рабочих нагрузок объединяйте проверки статуса и используйте единую очередь in-flight на ключ. Устойчиво более высокая пропускная способность доступна — свяжитесь с нами через Telegram или email для пользовательского лимита.
Webhook vs polling
Sunor в настоящее время не предлагает webhook-обратные вызовы — polling является поддерживаемым паттерном. Для 100+ одновременных задач один фоновый воркер, опрашивающий каждые 10 секунд с пакетным чтением статуса, эффективнее, чем polling per-task. Подпишитесь на обновления продукта для получения webhook.
Полная справка по API — docs.sunor.cc
Сколько стоит Suno API?
Оплата по факту использования. Без подписок и ежемесячных платежей. 1 credit = $0.01 USD.
| Тип task | Credits | Цена (USD) |
|---|---|---|
| Генерация музыки | 10 | $0.10 |
| Генерация текстов | 5 | $0.05 |
| Загрузка аудио | 1 | $0.01 |
| Склейка / Продление | 5 | $0.05 |
Полные детали цен — sunor.cc/pricing
Как Sunor сравнивается с другими провайдерами Suno API
Шесть активных провайдеров Suno API в 2026 — sunor.cc указан первым как издатель этого сравнения, остальные пять отсортированы по цене за вызов по возрастанию.
| Провайдер | Цена за вызов | Бесплатный уровень | Модель ценообразования | Особенности |
|---|---|---|---|---|
| sunor.cc | $0.10 / песня (10 кредитов) | 25 кредитов, без карты | PAYG, минимум $5 | Suno и Udio в одном REST API. PAYG с низким минимумом пополнения $5. Регистрация через Google OAuth, без карты на бесплатном уровне. |
| APIPASS † | ~$0.014 / запуск | PAYG, без срока действия | Оплата по факту использования | Самая дешёвая цена за вызов; без водяных знаков — но без официальных SDK (их собственный выбор дизайна), и устойчивость цены неясна. |
| apiframe.ai | ~$0.07 (план Basic, $19/мес) | 300 кредитов/мес, без карты | Уровни $0 / $19 / $99 / $199 / $2,499 | 4 официальных SDK (Node/Python/PHP/Go) + мультимодель (Suno + Udio + Midjourney + Flux) — но многоуровневая подписка от $19/мес, не PAYG. |
| evolink.ai | $0.111 / песня (8 кредитов) | не задокументировано | на основе кредитов | OpenAI-совместимый базовый URL (замена для существующих клиентов); 120+ моделей с автоматическим резервированием — но самая дорогая цена за вызов; нет задокументированного бесплатного уровня. |
| kie.ai † | на основе кредитов | варьируется | пакеты кредитов | Маркетируется как ~30% ниже официальной цены Suno; мультимодель — но конкретные тарифы публично не указаны. |
| sunoapi.org † | $19 – $199/мес | нет | только подписка | Только подписка с фиксированным ежемесячным распределением кредитов — только Suno (без Udio); доступ к V5 ограничен согласно их документации. |
† Данные о ценах взяты из сторонних обзоров; их публичные страницы цен не были напрямую доступны на момент проверки фактов (2026-06-05). Проверьте актуальные тарифы на сайте каждого провайдера перед принятием решения.
"model": "udio" в запросе task.Начните разработку с Suno API
Получите API key, сгенерируйте первый трек и внедрите AI-музыку в ваш продукт.
Sunor — неофициальная обёртка над Suno API, не связана с Suno Inc., не одобрена и не имеет официального сотрудничества с ней.