> ## Documentation Index > Fetch the complete documentation index at: https://docs.aiid.edu.kg/llms.txt > Use this file to discover all available pages before exploring further. # 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 ```http 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: ```json { "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.5" }, "data": [ { "id": "clip_xxx", "title": "夏日海风", "audio_url": "https://example.com/audio.mp3", "image_url": "https://example.com/cover.jpg", "model_name": "suno-v5.5", "metadata": { "duration": 180, "prompt": "轻快电子流行，夏日海边，女声 旋律" } } ] } } ``` ## OpenAPI ````yaml api-reference/vi/openapi.json GET /suno/fetch/{task_id} openapi: 3.0.0 info: title: Tài liệu tham khảo API của 出海营 version: 1.0.0 description: Public AI Gateway API Reference servers: - url: https://api.aiid.edu.kg security: - BearerAuth: [] tags: - name: Định dạng OpenAI (Chat) - name: Định dạng OpenAI (Responses) - name: Định dạng Gemini cho tạo ảnh - name: Tạo hình ảnhOpenAI định dạng DALL-E - name: Lấy danh sách mô hình - name: Tạo video HappyHorse và Wan - name: Định dạngKling tạo video - name: Định dạng Video Generation Omni và Veo - name: Tạo video Seedance - name: Định dạng tương thích Sora cho tạo video - name: Tạo video Vidu - name: Định dạng tác vụ tạo nhạc paths: /suno/fetch/{task_id}: get: tags: - Định dạng tác vụ tạo nhạc summary: Truy vấn tác vụ nhạc theo ID description: >- 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 ```http 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: ```json { "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.5" }, "data": [ { "id": "clip_xxx", "title": "夏日海风", "audio_url": "https://example.com/audio.mp3", "image_url": "https://example.com/cover.jpg", "model_name": "suno-v5.5", "metadata": { "duration": 180, "prompt": "轻快电子流行，夏日海边，女声 旋律" } } ] } } ``` parameters: - name: task_id in: path required: true schema: type: string example: task_xxx description: ID tác vụ được trả về khi gửi tác vụ âm nhạc. responses: '200': description: OK content: application/json: schema: type: object properties: code: type: string example: success description: Khi thành công là `success`. message: type: string description: Thông báo lỗi hoặc thông báo nhắc. data: type: object properties: task_id: type: string description: ID của tác vụ. status: type: string description: >- Trạng thái tác vụ, các giá trị thường gặp `NOT_START`、`SUBMITTED`、`QUEUED`、`IN_PROGRESS`、`SUCCESS`、`FAILURE`. progress: type: string description: Tiến độ tác vụ. result_url: type: string description: Địa chỉ kết quả khả dụng sau khi thành công. data: type: string items: type: object properties: audio_url: type: string description: URL âm thanh của bài hát. image_url: type: string description: URL ảnh bìa bài hát. title: type: string description: Tiêu đề bài hát. metadata: type: object properties: duration: type: string description: Độ dài âm thanh. examples: music_fetch_success: summary: Truy vấn tác vụ âm nhạc thành công value: 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.5 data: - id: clip_xxx title: 夏日海风 audio_url: https://example.com/audio.mp3 image_url: https://example.com/cover.jpg model_name: suno-v5.5 metadata: duration: 180 prompt: 轻快电子流行，夏日海边，女声 旋律 components: securitySchemes: BearerAuth: type: http scheme: bearer description: |- Sử dụng xác thực Bearer Token. Định dạng: `Authorization: Bearer sk-xxxxxx` ````