Запросить музыкальную задачу по ID

Через path task_id запросить задачу генерации музыки.

Интерфейс для запроса задачи генерации музыки. data, возвращаемый интерфейсом создания, — это ID задачи; используйте GET /suno/fetch/{task_id} для запроса отдельной задачи.

Способы запроса

GET /suno/fetch/task_xxx

Результат запроса

Внешний слой сохраняет структуру задачи new-api:

• code: при успехе — success.
• message: сообщение об ошибке или подсказка.
• data.task_id: ID задачи.
• data.status: статус задачи; типичные значения: NOT_START, SUBMITTED, QUEUED, IN_PROGRESS, SUCCESS, FAILURE.
• data.progress: прогресс задачи.
• data.result_url: доступный после успеха адрес результата; если вышестоящий сервис возвращает несколько песен, ориентируйтесь на фрагмент внутри data.data.
• data.data: исходные данные результата музыки от вышестоящего сервиса, обычно содержат массив или объект фрагментов песни.

Пример успешного состояния:

{
 "code": "success",
 "message": "",
 "data": {
 "task_id": "task_xxx",
 "platform": "suno",
 "action": "MUSIC",
 "status": "SUCCESS",
 "progress": "100%",
 "result_url": "https://example.com/audio.mp3",
 "properties": {
 "upstream_model_name": "suno_music",
 "origin_model_name": "suno-v5"
 },
 "data": [
 {
 "id": "clip_xxx",
 "title": "夏日海风",
 "audio_url": "https://example.com/audio.mp3",
 "image_url": "https://example.com/cover.jpg",
 "model_name": "suno-v5",
 "metadata": {
 "duration": 180,
 "prompt": "轻快电子流行，夏日海边，女声 旋律"
 }
 }
 ]
 }
}