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 самостоятельно.