API генерації звукових ефектів

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

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

Генерація звукових ефектів створює кілька секунд аудіо, а не пісню. Підходить для коротких звуків — грому, крапель дощу, удару — а також для переходів, ембієнту й барабанних лупів; більшість коротші за 5 секунд, найдовший — близько 20 секунд. Підтримуються режими одноразовий і циклічний.

Кінцева точка: POST /api/music/sounds

Оплата: платно, наразі типово 0,6 юаня за виклик. Фактично списана сума визначається поточною конфігурацією цін у бек-офісі.

Час очікування та тайм-аути (важливо): це синхронна кінцева точка — замовлення приймають і передають у генерацію лише коли надходить відповідь. За вимірами більшість запитів відповідають за 1-3 секунди, близько 10% тривають понад 30 секунд, а найдовший — близько 230 секунд. Установіть тайм-аут клієнта 300 секунд або більше; відсутність відповіді не означає, що нічого не згенеровано, і не повторюйте запит одразу після тайм-ауту (це дублює замовлення й списує кошти вдруге). Якщо з'єднання обірвалося, перевірте пізніше через GET /api/music/songs. Див. «Час очікування та налаштування тайм-ауту» в Огляді нового API.

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

Headers

Параметр	Тип	Обов'язково	Примітки
Authorization	string	так	Bearer YOUR_API_KEY
Content-Type	string	так	application/json

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

Параметр	Тип	Обов'язково	Типово	Примітки
model	string	ні	suno-v6	Клієнтська назва моделі: `suno-v6`, `suno-v6-wild` або `suno-v6-mini`
description	string	так	-	Опишіть потрібний звук; короткі англійські фрази працюють найстабільніше, наприклад `cinematic whoosh transition, bright impact`
title	string	ні	-	Назва; якщо не передавати, може бути згенерована з опису
type	string	ні	one_shot	Тип: `one_shot` (одноразовий) або `loop` (циклічний)
loop	boolean	ні	false	Чи відтворювати циклічно; еквівалентно встановленню `type` = `loop`
bpm	number	ні	-	BPM; має бути числом більшим за 0. Некоректне значення повертає 400 (`invalid_sound_bpm`), а не ігнорується мовчки
key	string	ні	-	Тональність у форматі назви ноти (C-B) + необов'язковий `#`/`b` + необов'язковий `Major`/`Minor`, наприклад `C Major`, `C#m`, `Bb`; порожнє значення або `any` означає без обмежень. Некоректне значення повертає 400 (`invalid_sound_key`)

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

curl -X POST https://www.suno-api.io/api/music/sounds \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "description": "cinematic whoosh transition, bright impact",
    "title": "cinematic whoosh",
    "type": "one_shot",
    "loop": false,
    "bpm": 120,
    "key": "C"
  }'

Відповідь

Повертається масив пісень; поля збігаються із загальними полями відповіді про пісню в Огляді нового API.

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

Отримати API-ключ

Створіть API-ключ у консолі після реєстрації. Одна генерація коштує 0,6 ¥ і повертає 2 треки, завантаження необмежені, номер телефону не потрібен.

Отримати API-ключ Повернутися до огляду