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
  }
}

Опис полів