Query Task

Query information about a song generation task.

API Information

• Method: GET
• Endpoint: /api/v1/music?action=song_query&task_id={task_id}
• Function: Query song task status

Authentication

BearerAuth Type: HTTP (bearer)

Request Parameters

Parameter	Type	Required	Description
task_id	string	Yes	Task ID

Response

Response Example (Processing)

{
  "code": 0,
  "message": "success",
  "resp_data": {
    "task_id": "task_1234567890abcdef",
    "created_at": 1640995200,
    "finished_at": 0,
    "model": "mureka-7.5",
    "status": "running",
    "failed_reason": "",
    "watermarked": false,
    "progress": 65,
    "choices": []
  }
}

Response Example (Completed)

{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "task_1234567890abcdef",
    "created_at": 1640995200,
    "finished_at": 1640995680,
    "model": "mureka-7.5",
    "status": "succeeded",
    "failed_reason": "",
    "watermarked": false,
    "progress": 100,
    "choices": [
      {
        "index": 0,
        "id": "song_1234567890abcdef",
        "url": "https://example.com/audio/song_1234567890abcdef.mp3",
        "flac_url": "https://example.com/audio/song_1234567890abcdef.flac",
        "stream_url": "",
        "duration": 240000,
        "lyrics_sections": [
          {
            "section_type": "verse",
            "start": 0,
            "end": 30000,
            "lines": [
              {
                "start": 0,
                "end": 15000,
                "text": "Youth blooms like flowers",
                "words": [
                  {
                    "start": 0,
                    "end": 5000,
                    "text": "Youth"
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  }
}

Request Example

curl -X GET "[HOST]/api/v1/music?action=song_query&task_id=task_1234567890abcdef" \
  -H "Authorization: Bearer YOUR_API_KEY"