audio_url, це загальнодоступна адреса аудіо CDN. mode за замовчуванням має значення standard, тому наявні виклики не потребують змін. Успішне звичайне завантаження споживає 0.06 Credits; у разі невдалого завантаження плата не стягується.
Тут введений нами audio_url — це https://cdn.acedata.cloud/suno_demo.mp3, загальнодоступна адреса CDN.
data завжди є об’єктом, а audio_id — це ID пісні після завантаження. Результати аналізу, такі як lyric, style, duration, заголовок і медіа-URL, є необов’язковими полями, конкретні значення залежать від поверненого вмісту.
Після отримання ID пісні можна через API генерації аудіо Suno викликати upload_extend, upload_cover або операції на кшталт вибірки інтервалів, які потребують audio_id. Якщо потрібно за допомогою функції творчості на основі натхнення Inspo створити нову музику на основі 1–4 повних референсних аудіо, безпосередньо викличте action=inspo і передайте список оригінальних загальнодоступних аудіо-URL; сервіс автоматично виконає завантаження та аналіз, без потреби клієнту формувати метадані аудіо.
Режим розширеного завантаження
audio_url є вхідною адресою та буде безпосередньо передано до процесу обробки аудіо, без попереднього перенесення службою постійного зберігання медіа в кінцевому стані. Переконайтеся, що він загальнодоступний протягом обробки завдання.
Коли звичайне завантаження не може обробити аудіо, яким ви володієте або на використання якого отримали дозвіл, можна встановити для mode значення enhanced. Цей режим також обов’язково потребує name від 1 до 100 символів і загальнодоступний HTTPS audio_url.
Розширене завантаження завжди використовує асинхронну обробку та зазвичай потребує 2 хвилин або більше. Успішна обробка споживає 1.87 Credits; у разі невдалої обробки плата не стягується.
task_id і trace_id. Використовуйте API завдань Suno для запиту завдання, після успішного завершення зчитайте ID завантаженого аудіо з response.data.audio_id. Також можна надати HTTPS callback_url для отримання кінцевого стану.
audio_id, отриманий унаслідок розширеного завантаження, можна використовувати для Cover, Samples і Mashup. Витягування інструменталу та MIDI, розділення всіх доріжок, а також розділення вокалу/інструменталу все ще можуть бути обмежені обліковим записом, якому належить аудіо; для не перелічених операцій підтримка між різними обліковими записами не гарантується. Що коротше аудіо, то зазвичай вищий показник успішної обробки.
