Страницы API моделей
Интеграция Suno Music API
Используйте Suno Music через Rivya Public API v1: model id suno-music, поддерживаемые входные данные, параметры, правила Files API, кредиты и примеры ответов.
Доступно через APIГотово для текстового вводаАудио
API model id
suno-music
Входные данные
text
Files API
Не требуется для минимального запроса
Базовые кредиты
12
Возможность
Аудио
Биллинг
FIXED
Лимит промпта
500 символов
Контракт запроса
Передавайте model id на верхнем уровне. Управляющие параметры конкретной модели размещайте в params.
| Ключ | Тип | Обязательно | По умолчанию | Описание |
|---|---|---|---|---|
| model | string | Да | suno-music | Используйте suno-music как API model id. |
| prompt | string | Да | - | Максимум 500 символов для этой модели. |
| params | object | Нет | - | Объект параметров конкретной модели. Допустимые ключи указаны в таблице ниже. |
| client_request_id | string | Нет | - | Необязательный клиентский id для трассировки запросов в вашей системе. |
Параметры модели
| Ключ | Тип | Обязательно | По умолчанию | Диапазон | Варианты | Описание |
|---|---|---|---|---|---|---|
| model | select | Нет | V4_5 | - | V4, V4_5, V4_5PLUS, V4_5ALL, V5, V5_5 | Выбирает, какое семейство генерации Suno использовать. Более новые версии часто лучше справляются со стилем и деталями, но могут отличаться по стоимости и поведению. |
| instrumental | select | Нет | false | - | false, true | Инструментал |
Минимальный запрос
{
"model": "suno-music",
"prompt": "A polished audio concept for a short product story",
"params": {
"model": "V4_5",
"instrumental": "false"
}
}Ответ создания
Эндпоинт создания возвращает публичный id задачи. Опрашивайте эндпоинт статуса, пока задача не завершится успехом или ошибкой.
{
"id": "task_suno_music_example",
"status": "queued",
"model": "suno-music",
"reserved_credits": 12,
"final_credits": 0,
"created_at": "2026-05-11T00:00:00.000Z",
"updated_at": "2026-05-11T00:00:00.000Z",
"result": null,
"error": null
}Распространенные ошибки
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
Эндпоинт создания возвращает публичный id задачи. Опрашивайте эндпоинт статуса, пока задача не завершится успехом или ошибкой.