Эндпоинт модели · POST /v2/generate
Suno v6 API
Генерируйте полные песни — вокал, текст и инструментал — через один асинхронный REST-эндпоинт. Семейство chirp-v6 включает флагманскую модель Suno v6, быстрый и экономичный уровень и более экспериментальный вариант, с оплатой за запрос в кредитах.
10–12 кредитов за песню · 1 USD = 100 кредитов
Что даёт Suno v6 API
Suno v6 API позволяет серверному приложению создавать полные песни из текстового промпта или собственного текста. Вы выбираете модель из семейства chirp-v6, отправляете один POST-запрос и получаете workId асинхронной задачи — вокал, структура и инструментовка создаются за вас.
Три актуальные модели используют один эндпоинт. chirp-v6 — флагман для продакшн-релизов. chirp-v6-mini — быстрый и экономичный уровень для больших объёмов и прототипов. chirp-v6-wild — более экспериментальный вариант для свободных, смелых аранжировок. Каждый результат сообщает в model_name модель, которая реально создала аудио, поэтому старые интеграции можно безопасно мигрировать.
Быстрый старт: создать задачу и опросить
Отправьте авторизованный POST на /v2/generate, сохраните возвращённый workId, затем опрашивайте /v2/feed до завершения задачи — или передайте callback_url и ждите вебхук.
curl -X POST "https://udioapi.pro/api/v2/generate" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "chirp-v6",
"prompt": "Verse 1: Walking down the street, feeling so free\nChorus: Summer dreams are calling me",
"style": "pop, upbeat, electronic, 120 bpm",
"title": "Summer Dreams",
"make_instrumental": false
}'
curl -X GET "https://udioapi.pro/api/v2/feed?workId=YOUR_WORK_ID"Генерация асинхронна. Опрашивайте каждые 5–10 секунд с ограниченным таймаутом и сразу скачивайте аудио-URL — медиассылки временные.
Модели и цены Suno v6
Все три модели доступны в generate, upload-cover и extend. Цены — за запрос; 1 USD = 100 кредитов.
| Модель | Кредиты | ≈ USD | Позиционирование |
|---|---|---|---|
| chirp-v6 | 12 | ≈ $0.12 | Флагман — песни максимального качества для продакшена |
| chirp-v6-mini | 10 | ≈ $0.10 | Быстрый и экономичный — пакетные задачи и прототипы |
| chirp-v6-wild | 12 | ≈ $0.12 | Более экспериментальный — смелые аранжировки |
Устаревшие идентификаторы продолжают работать по исторической цене: chirp-v5 и chirp-v5-5 обслуживаются chirp-v6; chirp-v3-5, chirp-v4-0, chirp-v4-5, chirp-v4-5-plus и chirp-v4-5-all — chirp-v6-mini. Без поля model запрос тарифицируется по базовому уровню 5 кредитов, который обслуживает chirp-v6-mini.
Что можно построить
Тот же аккаунт и API-ключ открывают все документированные аудио-эндпоинты.
Текст и лирика в песню
Custom Mode для текста, стиля и названия или Inspiration Mode из простого описания. Опциональные image_urls задают настроение.
Читать документациюПродлить существующий трек
Продолжите сгенерированную песню с унаследованными настройками или новым промптом и заберите результат из feed.
Читать документациюКавер на своё аудио
Загрузите аудио и создайте кавер-версию через эндпоинт upload-cover.
Читать документациюЛирика с таймкодами
Получайте тайминги построчно для караоке или синхронизированных текстов.
Читать документациюКонвертация в WAV
Преобразуйте сгенерированный трек в WAV для мастеринга или вещательных пайплайнов.
Читать документациюВебхуки и опрос
Выбирайте между опросом feed и callback-уведомлениями о завершении задачи.
Читать документациюКак это работает
От API-ключа до готового трека за четыре шага.
- 1
Создайте API-ключ
Войдите, откройте дашборд и скопируйте ключ. Храните его в серверном секрете — никогда в браузерном коде.
- 2
Отправьте задачу
POST на /v2/generate с моделью и промптом. Ответ вернёт workId асинхронной задачи.
- 3
Опрос или callback
Вызывайте GET /v2/feed?workId=... каждые 5–10 секунд или передайте callback_url и обработайте вебхук о завершении.
- 4
Скачайте аудио
При статусе SUCCESS ответ feed содержит временные аудио-URL. Сохраните файлы в собственном хранилище.
Ограничения и примечания
- Все эндпоинты генерации асинхронны; ответ POST содержит workId, а не аудио.
- Опрашивайте /v2/feed с ограниченными повторами или используйте callback_url для доставки сервер-сервер.
- Запросы с chirp-v5 и chirp-v5-5 производят аудио chirp-v6; более старые устаревшие идентификаторы — chirp-v6-mini.
- Медиа-URL временные — скачивайте результаты и храните у себя.
- Держите промпты, названия и стили в документированных пределах; более длинные значения обрезаются.
udioapi.pro — независимый сторонний сервис. Он не связан с Suno, Udio или MiniMax, не одобрен и не управляется ими.
FAQ по Suno v6 API
Ответы о моделях, оплате и асинхронном процессе.
Это официальный API Suno?
Нет. udioapi.pro — независимый сторонний API-сервис с собственными эндпоинтами, аккаунтами, кредитами, условиями и поддержкой. Он не связан с Suno или Udio, не одобрен и не управляется ими.
С какой модели Suno v6 начать?
Для прототипов и больших объёмов берите chirp-v6-mini — быстрый экономичный уровень за 10 кредитов. Переходите на chirp-v6 (12 кредитов), когда нужно флагманское качество, или на chirp-v6-wild для экспериментальных результатов.
Сколько стоит запрос?
chirp-v6 и chirp-v6-wild стоят 12 кредитов за запрос, chirp-v6-mini — 10. При 1 USD = 100 кредитов это примерно $0.10–$0.12 за песню. Без поля model тарифицируется базовый уровень 5 кредитов, обслуживаемый chirp-v6-mini.
Как получить сгенерированное аудио?
Каждый принятый запрос возвращает workId. Опрашивайте GET /v2/feed?workId=... каждые 5–10 секунд до статуса SUCCESS или передайте callback_url для вебхука. Ответ feed будет содержать аудио-URL.
Работают ли старые идентификаторы моделей?
Да. chirp-v5 и chirp-v5-5 обслуживает chirp-v6, а chirp-v3-5 — chirp-v4-5-all — chirp-v6-mini, каждый по исторической цене. model_name показывает модель, создавшую аудио.
Можно ли продлить или сделать кавер сгенерированной песни?
Да — семейство chirp-v6 доступно в generate, upload-cover и extend. Продления тарифицируются по цене модели исходного трека, а отклонённые или неудачные запросы возмещаются.