Skip to main content
POST
cURL
Загрузите аудио в Suno, чтобы получить jobId или music_id для последующих операций.
  • Когда is_async = false (синхронный режим): API будет блокировать ответ до завершения обработки и сразу вернет music_id.
⚠️ Поскольку должен завершиться весь процесс обработки, это может занять много времени.
  • Когда is_async = true (асинхронный режим): API немедленно вернет jobId. Вам нужно использовать этот jobId, чтобы вызвать API получения результата задачи и асинхронно получить финальный результат загрузки.

Авторизации

TT-API-KEY
string
header
обязательно

Вы можете получить API-ключ в панель управления TTAPI.

Тело

application/json
audio_url
string
обязательно

URL аудио должен быть общедоступным

is_async
boolean
по умолчанию:false

Асинхронный режим:

  • false: синхронное ожидание

  • true: асинхронное получение результата

hookUrl
string

URL обратного уведомления

Ответ

Запрос выполнен успешно

status
string
обязательно
Пример:

"SUCCESS"

message
string
обязательно
Пример:

"success"

data
object
обязательно

При синхронной загрузке (is_async=false) интерфейс ожидает завершения и возвращает идентификатор аудио; запрос может выполняться долго.

Пример:
Последнее изменение 3 июля 2026 г.