# Get Extend Music Task Status

> Audio Generation

Query the status and results of an extend music task.

**Task Status Description**:
- `Pending`: Waiting
- `Processing`: Processing
- `Success`: Completed
- `Failed`: Failed

## Endpoint

`GET https://api.modelverse.cn/v1/tasks/status`

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| task_id | query | string | Yes | Task ID |

## Responses

- **200** — Query successful
- **400** — 
- **401** — 
- **404** — 
- **500** — 

## OpenAPI Definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Suno Extend Music",
    "description": "Extend existing Suno-generated music.\n\n**Models**: `suno-v4`, `suno-v4.5`, `suno-v4.5+`, `suno-v4.5-all`, `suno-v5`, `suno-v5.5`\n\n**API Type**: Asynchronous Task\n\n**Billing**: Per request, 1 credit for successful tasks\n",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://api.modelverse.cn",
      "description": "Production Environment"
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "paths": {
    "/v1/tasks/submit": {
      "post": {
        "operationId": "submitSunoExtendMusicTask",
        "summary": "Submit Extend Music Task",
        "description": "Submit an extend music task. Extend existing Suno-generated music.\n\n**Notes**:\n- When extending music, the model must match the source audio's model version\n- continue_at must be greater than 0 and less than the original audio duration\n- Generated files retention period: 15 days\n",
        "tags": [
          "Suno"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ExtendMusicRequest"
              },
              "examples": {
                "customParams": {
                  "summary": "Custom Parameters Mode",
                  "value": {
                    "model": "suno-v4.5",
                    "input": {
                      "prompt": "Add more relaxing notes"
                    },
                    "parameters": {
                      "task": "extend",
                      "audio_id": "abc123",
                      "default_param_flag": true,
                      "continue_at": 60,
                      "tags": "Classical",
                      "title": "Peaceful Piano Extended",
                      "make_instrumental": false,
                      "vocal_gender": "m",
                      "persona_id": "persona_123",
                      "negative_tags": "Relaxing Piano",
                      "style_weight": 0.65,
                      "weirdness_constraint": 0.65,
                      "audio_weight": 0.65
                    }
                  }
                },
                "defaultParams": {
                  "summary": "Default Parameters Mode",
                  "value": {
                    "model": "suno-v4.5",
                    "parameters": {
                      "task": "extend",
                      "audio_id": "abc123",
                      "default_param_flag": false
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Task submitted successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TaskSubmitResponse"
                },
                "example": {
                  "code": 0,
                  "message": "success",
                  "data": {
                    "task_id": "task_abc123xyz",
                    "status": "pending"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "../common/modelverse-errors.yaml#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "../common/modelverse-errors.yaml#/components/responses/Unauthorized"
          },
          "429": {
            "$ref": "../common/modelverse-errors.yaml#/components/responses/RateLimitExceeded"
          },
          "500": {
            "$ref": "../common/modelverse-errors.yaml#/components/responses/InternalServerError"
          }
        }
      }
    },
    "/v1/tasks/status": {
      "get": {
        "operationId": "getSunoExtendMusicTaskStatus",
        "summary": "Get Extend Music Task Status",
        "description": "Query the status and results of an extend music task.\n\n**Task Status Description**:\n- `Pending`: Waiting\n- `Processing`: Processing\n- `Success`: Completed\n- `Failed`: Failed\n",
        "tags": [
          "Suno"
        ],
        "parameters": [
          {
            "name": "task_id",
            "in": "query",
            "required": true,
            "description": "Task ID",
            "schema": {
              "type": "string",
              "example": "task_abc123xyz"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Query successful",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TaskStatusResponse"
                },
                "examples": {
                  "pending": {
                    "summary": "Pending",
                    "value": {
                      "code": 0,
                      "message": "success",
                      "data": {
                        "task_id": "19afee7ca36bf81a85bdc11adf41f310",
                        "task_status": "Pending",
                        "submit_time": 1788314983,
                        "finish_time": 0
                      },
                      "usage": {
                        "prompt_tokens": 0,
                        "completion_tokens": 0,
                        "total_tokens": 0
                      },
                      "request_id": ""
                    }
                  },
                  "success": {
                    "summary": "Completed",
                    "value": {
                      "code": 0,
                      "message": "success",
                      "data": {
                        "task_id": "19afee7ca36bf81a85bdc11adf41f310",
                        "task_status": "Success",
                        "urls": [
                          "https://tempfile.aiquickdraw.com/r/2bf2e37e-e6f9-454a-9925-05caffd46032.m4a?clip_id=2bf2e37e-e6f9-454a-9925-05caffd46032",
                          "https://tempfile.aiquickdraw.com/r/d2ddbe3e-9a59-4f5a-b533-03a0f49c19c7.m4a?clip_id=d2ddbe3e-9a59-4f5a-b533-03a0f49c19c7"
                        ],
                        "submit_time": 1788314983,
                        "finish_time": 1788314983
                      },
                      "usage": {
                        "prompt_tokens": 0,
                        "completion_tokens": 0,
                        "total_tokens": 0
                      },
                      "request_id": ""
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "../common/modelverse-errors.yaml#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "../common/modelverse-errors.yaml#/components/responses/Unauthorized"
          },
          "404": {
            "$ref": "../common/modelverse-errors.yaml#/components/responses/NotFound"
          },
          "500": {
            "$ref": "../common/modelverse-errors.yaml#/components/responses/InternalServerError"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "description": "API Key Authentication"
      }
    },
    "schemas": {
      "ExtendMusicRequest": {
        "type": "object",
        "required": [
          "model",
          "parameters"
        ],
        "properties": {
          "model": {
            "type": "string",
            "description": "Model name",
            "enum": [
              "suno-v4",
              "suno-v4.5",
              "suno-v4.5+",
              "suno-v4.5-all",
              "suno-v5",
              "suno-v5.5"
            ],
            "example": "suno-v4.5"
          },
          "input": {
            "type": "object",
            "description": "Input parameters",
            "properties": {
              "prompt": {
                "type": "string",
                "description": "Describe how the music should be extended. Required when default_param_flag is true and make_instrumental is false. Prohibited when make_instrumental is true.\n",
                "example": "Add more relaxing notes"
              }
            }
          },
          "parameters": {
            "type": "object",
            "required": [
              "task",
              "audio_id",
              "default_param_flag",
              "continue_at"
            ],
            "properties": {
              "task": {
                "type": "string",
                "description": "Task type",
                "enum": [
                  "extend"
                ],
                "example": "extend"
              },
              "audio_id": {
                "type": "string",
                "description": "Audio ID to extend (Suno-generated)",
                "example": "abc123"
              },
              "default_param_flag": {
                "type": "boolean",
                "description": "true=use custom parameters, false=use original audio parameters.\nWhen true, tags and title parameters are required.\n",
                "example": true
              },
              "continue_at": {
                "type": "number",
                "description": "Start extending from second (must be greater than 0)",
                "minimum": 0,
                "exclusiveMinimum": true,
                "example": 60
              },
              "tags": {
                "type": "string",
                "description": "Music style (required when default_param_flag=true)",
                "example": "Classical"
              },
              "title": {
                "type": "string",
                "description": "Music title (required when default_param_flag=true)",
                "example": "Peaceful Piano Extended"
              },
              "make_instrumental": {
                "type": "boolean",
                "description": "Whether to generate instrumental music (no vocals). If true, prompt and vocal_gender parameters are prohibited.\nOptional, default is false.\n\n**Note**:\n- If the source music has vocals, this option cannot configure the extended part as instrumental\n- If the source music is instrumental, this option can be combined with prompt, vocal_gender, etc. to configure the extended part with vocals\n",
                "default": false,
                "example": false
              },
              "vocal_gender": {
                "type": "string",
                "description": "Desired vocal gender. Optional when make_instrumental is false; prohibited when make_instrumental is true.\n\n**Note**: This parameter produces unstable results.\n",
                "enum": [
                  "m",
                  "f"
                ],
                "example": "m"
              },
              "persona_id": {
                "type": "string",
                "description": "Persona ID (only supported by suno-v5, suno-v5.5).\nOnly available when default_param_flag is true.\n",
                "example": "persona_123"
              },
              "negative_tags": {
                "type": "string",
                "description": "Negative style tags",
                "example": "Relaxing Piano"
              },
              "style_weight": {
                "type": "number",
                "description": "Style weight. Range 0.00–1.00, must be a multiple of 0.01.\n",
                "minimum": 0,
                "maximum": 1,
                "multipleOf": 0.01,
                "example": 0.65
              },
              "weirdness_constraint": {
                "type": "number",
                "description": "Creativity divergence. Range 0.00–1.00, must be a multiple of 0.01.\n",
                "minimum": 0,
                "maximum": 1,
                "multipleOf": 0.01,
                "example": 0.65
              },
              "audio_weight": {
                "type": "number",
                "description": "Audio influence weight. Range 0.00–1.00, must be a multiple of 0.01.\n",
                "minimum": 0,
                "maximum": 1,
                "multipleOf": 0.01,
                "example": 0.65
              }
            }
          }
        }
      },
      "TaskSubmitResponse": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "description": "Status code, 0 indicates success",
            "example": 0
          },
          "message": {
            "type": "string",
            "description": "Status message",
            "example": "success"
          },
          "data": {
            "type": "object",
            "properties": {
              "task_id": {
                "type": "string",
                "description": "Task ID",
                "example": "task_abc123xyz"
              },
              "status": {
                "type": "string",
                "description": "Task status",
                "enum": [
                  "pending",
                  "processing",
                  "completed",
                  "failed"
                ],
                "example": "pending"
              }
            }
          }
        }
      },
      "TaskStatusResponse": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "description": "Status code, 0 indicates success",
            "example": 0
          },
          "message": {
            "type": "string",
            "description": "Status message",
            "example": "success"
          },
          "data": {
            "type": "object",
            "properties": {
              "task_id": {
                "type": "string",
                "description": "Task ID",
                "example": "19afee7ca36bf81a85bdc11adf41f310"
              },
              "task_status": {
                "type": "string",
                "description": "Task status",
                "enum": [
                  "Pending",
                  "Processing",
                  "Success",
                  "Failed"
                ],
                "example": "Success"
              },
              "urls": {
                "type": "array",
                "description": "List of generated audio file URLs",
                "items": {
                  "type": "string",
                  "format": "uri"
                },
                "example": [
                  "https://tempfile.aiquickdraw.com/r/2bf2e37e-e6f9-454a-9925-05caffd46032.m4a?clip_id=2bf2e37e-e6f9-454a-9925-05caffd46032",
                  "https://tempfile.aiquickdraw.com/r/d2ddbe3e-9a59-4f5a-b533-03a0f49c19c7.m4a?clip_id=d2ddbe3e-9a59-4f5a-b533-03a0f49c19c7"
                ]
              },
              "submit_time": {
                "type": "integer",
                "description": "Submission timestamp",
                "example": 1788314983
              },
              "finish_time": {
                "type": "integer",
                "description": "Completion timestamp",
                "example": 1788314983
              }
            }
          },
          "usage": {
            "type": "object",
            "description": "Token usage",
            "properties": {
              "prompt_tokens": {
                "type": "integer",
                "description": "Input token count",
                "example": 0
              },
              "completion_tokens": {
                "type": "integer",
                "description": "Output token count",
                "example": 0
              },
              "total_tokens": {
                "type": "integer",
                "description": "Total token count",
                "example": 0
              }
            }
          },
          "request_id": {
            "type": "string",
            "description": "Request ID",
            "example": ""
          }
        }
      }
    }
  }
}
```