Truy vấn tác vụ nhạc theo ID

Truy vấn tác vụ tạo nhạc thông qua path task_id.

API truy vấn tác vụ tạo nhạc. data trả về từ API tạo chính là ID tác vụ, dùng GET /suno/fetch/{task_id} để truy vấn một tác vụ đơn.

Cách truy vấn

GET /suno/fetch/task_xxx

Đầu ra truy vấn

Giữ nguyên cấu trúc tác vụ new-api ở lớp ngoài:

• code: Khi thành công là success.
• message: Thông báo lỗi hoặc thông báo gợi ý.
• data.task_id: ID tác vụ.
• data.status: Trạng thái tác vụ, các giá trị thường gặp gồm NOT_START, SUBMITTED, QUEUED, IN_PROGRESS, SUCCESS, FAILURE.
• data.progress: Tiến độ tác vụ.
• data.result_url: Địa chỉ kết quả có thể dùng sau khi thành công; nếu upstream trả về nhiều bài hát, lấy đoạn trong data.data làm chuẩn.
• data.data: Dữ liệu gốc kết quả âm nhạc từ upstream, thường bao gồm mảng hoặc đối tượng các đoạn bài hát.

Ví dụ trạng thái thành công:

{
 "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": "轻快电子流行，夏日海边，女声 旋律"
 }
 }
 ]
 }
}