Пока это руководство есть только на английском. →
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
audio_weight | Нет | How strongly a persona's audio shapes the result, from 0 to 1. Songs with vocals only. ≥ 0 · ≤ 1 |
generate_lyrics | Нет | Let the model write the lyrics from the prompt. Only applies when lyrics is empty and instrumental is off. По умолчанию: true |
image_urls | Нет | Картинки, задающие настроение: музыка подхватит их атмосферу. |
instrumental | Нет | Только музыка, без вокала. По умолчанию: false |
lyrics | Нет | Напишите свой текст или доверьте его модели. |
negative_prompt | Нет | Стили или звуки, которых не должно быть в треке. |
persona_id | Нет | ID of an existing Suno persona to reuse its style or voice. |
persona_model | Нет | Whether persona_id is a style persona or a voice persona. style_persona · voice_persona |
prompt | Да | Describe the song: genre, mood, tempo, instruments and voice. With lyrics or an instrumental this is the style (up to 1,000 characters); with no lyrics the model writes the words from it. |
reference_audio_urls | Нет | Звук-образец: голос, музыка или ритм. |
reference_video_urls | Нет | Видео, под которое нужно подстроить музыку. |
style_weight | Нет | How closely to follow the style in the prompt, from 0 to 1. ≥ 0 · ≤ 1 |
title | Нет | Song title (metadata, not sung). Applies with lyrics or an instrumental; otherwise the model names the song. |
variety | Нет | How different the two versions are from each other: 0 off, 1 normal (the model default), 2 high, 3 extra, 4 max. ≥ 0 · ≤ 4 |
vocal_gender | Нет | Make a female or male lead vocal more likely. Applies with lyrics. female · male |
weirdness | Нет | How experimental the song may get, from 0 (conventional) to 1 (unusual). ≥ 0 · ≤ 1 |
Цены
Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,01). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.
| Вариант | Кредиты за генерацию | ≈ USD |
|---|---|---|
| Стандарт | 10,8 | 0,11 $ |
Каждая задача округляется вверх до целых кредитов, поэтому один запуск на самом дешёвом уровне стоит 11 кредитов за генерацию (0,11 $).
Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.
Быстрый старт API
Вызов API Suno v6 в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
- Отправьте запрос. Отправьте POST /jobs/createTask с model suno/v6/text-to-audio и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
- Получите результат. Опрашивайте GET /jobs/recordInfo по ID задачи или передайте callBackUrl — мы отправим результат туда. Когда задача выполнится, скачайте файлы по ссылкам.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "suno/v6/text-to-audio",
"input": {
"prompt": "Calm ambient pads with a slow rising motif"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Замените промпт и ссылки на свои. Справка по ответу, опросу статуса и callback есть на вкладке API.
Вопросы об API Suno v6
Сколько стоит API Suno v6?
Suno v6 стоит 11 кредитов (0,11 $) за генерацию. Кредиты те же, что и на сайте (1 кредит = 0,01 $), новые аккаунты получают 30 бесплатных кредитов, а за неудачные задачи кредиты возвращаются.
Какое имя модели у Suno v6 в API?
Укажите suno/v6/text-to-audio — Музыка в поле model запроса POST /jobs/createTask.
Что Suno говорит о v6?
Suno называет v6 надёжной и точной моделью, которая стабильно создаёт отточенную музыку во всех жанрах и стилях. Она вышла 9 сентября 2026 года вместе с v6 Wild и v6 Mini.
Споёт ли она мой текст в точности?
В наших тестах при настройках по умолчанию — да. Текст из 11 строк был спет слово в слово, в том порядке, как написан; теги секций вроде [Chorus] не пелись, а припев сам по себе не повторялся.
Списываются ли деньги, если запрос отклонён или завершился ошибкой?
Нет. Сумма, зарезервированная под запрос, освобождается полностью.
Можно ли выбрать, кто поёт?
Отчасти. Опишите голос в описании стиля, например уверенным женским вокалом. Со своим текстом или при включённом instrumental можно также задать vocal_gender — female или male; это пожелание, а не гарантия, и как часто оно выполняется, мы не измеряли. Дуэт, заказанный одной фразой, в нашем тесте вернулся сольным, так что, если это важно, назовите один голос.
Какие ограничения у API Suno v6?
Референсные изображения: 5; Референсное аудио: 1; Референсные видео: 1; Длина промпта (символов): 3,000. Запросы за пределами этих ограничений отклоняются до любого списания.
Можно попробовать Suno v6 без кода?
Да. Playground запускает Suno v6 на ваших кредитах PopNow без API-ключа и показывает код для каждой генерации.
Все модели Suno
Suno v6 — надёжный выбор, когда песня уже у тебя в голове. v6 Wild уходит в более неожиданные, фактурные решения, а v6 Mini — быстрый черновик; цена за запуск у всех одинаковая.

