List music projects

Page through the Text-to-Music projects owned by your account.

GET /sound_clone/api/v1/music/projects

curl --location 'https://api.myvocal.ai/sound_clone/api/v1/music/projects?page=1&pageSize=20' \
--header 'accessKey: <your_api_key>'

200 Success

{
  "code": 1,
  "message": "success",
  "data": {
    "page": 1,
    "pageSize": 20,
    "total": 3,
    "totalPage": 1,
    "list": [
      { "projectId": "mup_...", "name": "Coast Road", "projectStatus": "READY", "createdAt": "2027-01-15T15:50:02", "updatedAt": "2027-01-15T15:56:40" }
    ],
    "requestId": "..."
  }
}

_{Text to Music · Workflow: Text-to-Music quickstart · Polling: Async jobs and retries}

Header

accessKey · string · required

Your API key. See Authentication.

Query

page · number · required

Page number, >= 1.

pageSize · number · required

Page size: 10, 20 or 50.

Response

page · number

Echoed page number.

pageSize · number

Echoed page size.

total · number

Total number of projects.

totalPage · number

Total number of pages.

list · array

Entries shaped { projectId, name, projectStatus, createdAt, updatedAt }.

curl --location 'https://api.myvocal.ai/sound_clone/api/v1/music/projects?page=1&pageSize=20' \
--header 'accessKey: <your_api_key>'

200 Success

{
  "code": 1,
  "message": "success",
  "data": {
    "page": 1,
    "pageSize": 20,
    "total": 3,
    "totalPage": 1,
    "list": [
      { "projectId": "mup_...", "name": "Coast Road", "projectStatus": "READY", "createdAt": "2027-01-15T15:50:02", "updatedAt": "2027-01-15T15:56:40" }
    ],
    "requestId": "..."
  }
}

Common errors

• code = 47001: page is below 1, or pageSize is not 10, 20 or 50.