Получить задачу
Получение статуса и результата задачи Suno MJ по ID; разные типы задач возвращают разные поля результата.
Используйте ID задачи, возвращённый интерфейсом отправки, для получения её статуса и результата.
/suno/mj/fetch/{job_id}Аутентификация
bearerAuth Используйте Authorization: Bearer your-api-key для аутентификации.
Расположение: header
Параметры пути
ID задачи, возвращённый интерфейсом отправки; прочитайте jobId или job_id из соответствующего ответа. Это не ID трека.
Тело ответа
application/json
application/json
application/json
ID задачи и ID трека
| Идентификатор | Назначение |
|---|---|
jobId / job_id | ID задачи для получения статуса и результата; читайте его из фактического ответа соответствующего интерфейса отправки. |
music_id / musicId | ID трека для кавера, продолжения песни, добавления вокала или аккомпанемента. |
Загрузить референсное аудио поддерживает синхронный и асинхронный режимы. При успешной синхронной загрузке сразу возвращается ID трека; после завершения асинхронной загрузки ID трека находится в ответе получения задачи в data.data.data.musics[].musicId. Не используйте ID трека вместо ID задачи при получении результата. Для нескольких задач используйте Получить задачи пакетом.
Статус и результат
| Статус | Значение |
|---|---|
NOT_START | Задача создана, обработка ещё не началась. |
QUEUED | Задача ожидает в очереди. |
ON_QUEUE | В очереди. |
SUCCESS | Задача выполнена успешно; прочитайте результат соответствующего типа. |
FAILED | Задача завершилась ошибкой; проверьте возвращённую информацию об ошибке. |
status: SUCCESS в ответе отправки означает успешное принятие запроса, а не завершение асинхронной задачи. Внешнее поле code: success ответа получения задачи означает успешное выполнение запроса получения; статус задачи читайте из data.status. После завершения генерации музыки или асинхронной загрузки треки находятся в data.data.data.musics[]. Поле musicId каждого трека используется для дальнейших операций, а audioUrl указывает на аудио; при отсутствии названия title может быть null. Поля результата других типов задач могут отличаться; нельзя напрямую применять к ним эту структуру.
Уведомления обратного вызова
При отправке запроса можно дополнительно указать hookUrl для получения уведомлений о задаче, пересылаемых платформой. URL обратного вызова поддерживает только порты 80, 443, 8080 и 8443.
Если hookUrl не указан, можно самостоятельно получать задачу; обновление статуса может происходить с задержкой. После настройки обратного вызова интерфейс получения задачи по-прежнему доступен. Конфигурация обратного вызова определяется hookUrl в запросе отправки; не используйте data.hookUrl из ответа получения задачи для определения URL обратного вызова.