Suno API

RouteAPI предоставляет единый REST API для генерации музыки Suno AI. Генерируйте музыку из текста, продлевайте песни, клонируйте голоса, разделяйте стемы и многое другое.

Base URL: https://api.routeapi.ai
Аутентификация: Authorization: Bearer sk-xxxx

Обзор рабочего процесса

Генерация музыки Suno является асинхронной. Типичный процесс:

Отправить задачу на /suno/audios → получить task_id
Подождать 2-3 секунды перед началом опроса
Опрашивать каждые 3-5 секунд через /suno/tasks с action: "retrieve"
Когда status становится success → получить audio_url

Статусы задачи

Статус	Значение	Следующий шаг
`submitted`	Отправлено, ожидание	Продолжить опрос
`queued`	В очереди	Продолжить опрос
`in_progress`	Генерация	Продолжить опрос
`success`	✅ Завершено	Получить `data.audio_url`
`failed`	❌ Ошибка	Проверить поле `error`

Быстрый старт

Шаг 1: Отправить задачу

curl -X POST "https://api.routeapi.ai/suno/audios" \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "chirp-v5-5",
    "prompt": "A cheerful summer pop song with piano and guitar",
    "async": true
  }'

Шаг 2: Опросить результат

curl -X POST "https://api.routeapi.ai/suno/tasks" \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{ "action": "retrieve", "id": "task_xxxxx" }'

Шаг 3: Получить аудио

{
  "id": "task_xxxxx",
  "status": "success",
  "data": {
    "audio_url": "https://cdn.suno.ai/xxx.mp3",
    "duration": 183.5
  }
}

Поддерживаемые модели

ID модели	Макс. длина	Лимит lyric	Лимит style
`chirp-v5-5`	8 минут	5000 символов	1000 символов
`chirp-v5`	8 минут	5000 символов	1000 символов
`chirp-v4`	150 секунд	3000 символов	200 символов

POST /suno/audios

Основная конечная точка, поддерживающая все 18 аудио операций.

Основные параметры

Поле	Тип	По умолчанию	Описание
`model`	string	`chirp-v4`	Модель генерации, рекомендуется `chirp-v5-5`
`action`	string	`generate`	Тип операции
`async`	boolean	`false`	Настоятельно рекомендуется `true`

Типы действий

Action	Описание	Обязательные поля
`generate`	Создать новую музыку из промпта	`prompt`
`extend`	Продлить существующее аудио	`audio_id` + `continue_at`
`cover`	Переосмыслить существующую песню	`audio_id`
`stems`	Разделить на вокал + инструментал	`audio_id`
`remaster`	Ремастеринг аудио для улучшения качества	`audio_id`

Для полного списка типов действий см. документацию на английском или китайском языке.

POST /suno/tasks

Запрос статуса и результатов задачи.

curl -X POST "https://api.routeapi.ai/suno/tasks" \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{ "action": "retrieve", "id": "task_xxxxx" }'

Другие конечные точки

Конечная точка	Метод	Описание
`/suno/lyrics`	POST	Генерация текста песни
`/suno/upload`	POST	Загрузка внешнего аудио файла
`/suno/persona`	GET/POST	Управление голосовыми персонами
`/suno/wav`	POST	Экспорт в формат WAV

Для полной справки API см. документацию на английском или китайском языке.

Часто задаваемые вопросы

Q: Какую модель использовать?
Используйте chirp-v5-5 (новейшая и самая мощная).

Q: Сколько времени занимает генерация?
generate обычно занимает 15-40 секунд.

Q: Можно ли использовать audio_url напрямую?
Да, CDN ссылка готова для воспроизведения или загрузки.