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

Авторизации

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

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

Тело

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

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

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

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

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

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

При upload_mode=enhanced должно быть true.

upload_mode
enum<string>
по умолчанию:default

Режим загрузки.

  • default: обычная загрузка, стоимость 0.5 quota
  • enhanced: улучшенная загрузка, снижает вероятность сбоев, стоимость 1 quota. Только асинхронно; необходимо использовать с is_async=true
Доступные опции:
default,
enhanced
hookUrl
string

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

Ответ

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

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

"SUCCESS"

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

"success"

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

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

Пример:
Последнее изменение 16 сентября 2026 г.