Сторінки API моделей
API-інтеграція для Suno Music
Використовуйте Suno Music через Rivya Public API v1 з ID моделі suno-music, підтримуваними входами, параметрами, правилами Files API, кредитами й прикладами відповідей.
Доступно через APIТекстовий ввід готовийАудіо
ID моделі API
suno-music
Входи
text
Files API
Не потрібно для мінімального запиту
Базові кредити
12
Можливість
Аудіо
Білінг
FIXED
Ліміт промпта
500 символів
Контракт запиту
Надсилайте ID моделі на верхньому рівні. Керування конкретної моделі належить у params.
| Ключ | Тип | Обов'язково | За замовчуванням | Опис |
|---|---|---|---|---|
| model | string | Так | suno-music | Використовуйте suno-music як ID моделі API. |
| 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 задачі. Опитуйте ендпоінт статусу, доки задача не завершиться успішно або з помилкою.