API генерації тексту пісні

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

Опис кінцевої точки

Генерація тексту створює або переписує текст пісні за темою, контекстом наявного тексту та вимогами до стилю. Цю кінцеву точку вже переведено на найновіший контракт генерації тексту, і її можна одразу використовувати для генерації в професійному режимі.

Кінцева точка: POST /api/lyrics/generate

Оплата: Безкоштовно в межах квоти (не більше 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.

Автентифікація

Параметри запиту

instruction також приймає старі поля theme і prompt. metadata.lyrics_model типово default, metadata.enable_thinking типово false.

Керування мовою

Ця кінцева точка не має окремого поля запиту language. Мову тексту визначає вміст instruction; style може відігравати лише допоміжну роль.

Щоб отримати текст китайською, явно вкажіть цільову мову в instruction, наприклад:

{
  "model": "suno-v6",
  "instruction": "请用中文写歌词，主题是夏夜海边重逢",
  "style": "Mandopop, 中文流行"
}

Можна також написати "Write the lyrics in Chinese about ...". Щоб отримати текст англійською, напишіть "请用英文写歌词" або "Write the lyrics in English". Якщо передати лише англійську тему й не вказати цільову мову, результат може бути англійською.

Приклад запиту

curl -X POST https://www.suno-api.io/api/lyrics/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "instruction": "Текст пісні українською про випускний і новий старт",
    "style": "поп-рок, щиро, пам'ятний приспів",
    "title": "Новий старт",
    "metadata": {
      "lyrics_model": "default",
      "enable_thinking": false
    }
  }'

Відповідь

{
  "code": 200,
  "message": "success",
  "data": {
    "lyrics": "[Verse]\nВітер лине над шкільним двором\nМи махаємо вчорашньому дню",
    "edited_lyrics": "[Verse]\nВітер лине над шкільним двором\nМи махаємо вчорашньому дню",
    "lyrics_id": "lyrics_id",
    "lyrics_request_id": "lyrics_request_id"
  }
}

edited_lyrics — повний текст, який слід вставити в поле тексту пісні. lyrics_id і lyrics_request_id призначені для відстеження й можуть бути порожніми залежно від відповіді кінцевої точки; не вважайте їх ідентифікаторами пісні.

Примітки щодо сумісності

• Старі поля theme і prompt усе ще працюють і приводяться до instruction.
• Серію кінцевих точок «проєкт тексту / автор тексту» закрито: якщо потрібно зберегти результати генерації, зберігайте отриманий edited_lyrics самостійно.