API подсказок промптов

Обновлено 2026-09-18 · команда Suno-API

Описание эндпоинта

Эндпоинт подсказок промптов возвращает случайные описания песен, темы текстов и предложения тегов стиля. Подходит для кнопок «случайное вдохновение» и «обновить теги».

Эндпоинт: POST /api/prompts/suggestions

Оплата: Бесплатно в пределах квоты (не более 10 вызовов в минуту и 300 в день на пользователя); сверх бесплатной квоты — 0,1 ¥ за вызов.

Определение превышения: при превышении бесплатной квоты запрос всё равно выполняется нормально, а в заголовках ответа приходят X-Suno-Helper-Free: false и X-Suno-Helper-Over-Limit: minute (или day), по ним клиент может сообщить, что этот вызов был платным.

Рекомендуемая модель: suno-v6. Доступны suno-v6, suno-v6-wild и suno-v6-mini.

Аутентификация

Параметры запроса

Пример запроса

curl -X POST https://www.suno-api.io/api/prompts/suggestions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6"
  }'

Ответ

{
  "code": 200,
  "message": "success",
  "data": {
    "prompts": ["A dreamy synth-pop track about city lights after rain"],
    "lyrics_prompts": ["Напиши русский текст о ночи, встрече и сожалении"],
    "tags": ["dreamy synth-pop", "warm piano", "male vocal"],
    "is_pending_personalization": false
  }
}

Описание полей