Get a music job

Read the progress of an arrangement or song job.

GET /sound_clone/api/v1/music/jobs/{jobId}

curl --location 'https://api.myvocal.ai/sound_clone/api/v1/music/jobs/muj_...' \
--header 'accessKey: <your_api_key>'

200 Success

{
  "code": 1,
  "message": "success",
  "data": {
    "jobId": "muj_...",
    "projectId": "mup_...",
    "jobType": "SONG",
    "status": "GENERATING",
    "displayStage": "CREATING_MUSIC_AND_VOCALS",
    "terminal": false,
    "failure": null,
    "attemptCount": null,
    "createdAt": "2027-01-15T15:53:20",
    "updatedAt": "2027-01-15T15:55:01",
    "requestId": "..."
  }
}

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

​

Header

accessKey · string · required

Your API key. See Authentication.

​

Path

jobId · string · required

The job identifier returned by create, regenerate or generate.

​

Response

jobId · string

Job identifier.

projectId · string

The project this job belongs to.

jobType · string

ARRANGEMENT or SONG.

status · string

QUEUED, GENERATING, FINALIZING, SETTLING, READY, FAILED or RECOVERY_REQUIRED.

displayStage · string

Coarser user-facing stage: QUEUED, CREATING_MUSIC_AND_VOCALS, FINALIZING_LIBRARY_ITEM or RECOVERY_REQUIRED.

terminal · boolean

true only for READY, FAILED and RELEASED.

failure · object | null

Populated when the job failed.

attemptCount · string | null

How many delivery attempts this ARRANGEMENT job has had, as a decimal string (for example "0" or "3"). null for SONG jobs, which do not use the arrangement retry counter.

createdAt · string

Timestamp, yyyy-MM-dd'T'HH:mm:ss.

updatedAt · string

Timestamp, yyyy-MM-dd'T'HH:mm:ss.

curl --location 'https://api.myvocal.ai/sound_clone/api/v1/music/jobs/muj_...' \
--header 'accessKey: <your_api_key>'

200 Success

{
  "code": 1,
  "message": "success",
  "data": {
    "jobId": "muj_...",
    "projectId": "mup_...",
    "jobType": "SONG",
    "status": "GENERATING",
    "displayStage": "CREATING_MUSIC_AND_VOCALS",
    "terminal": false,
    "failure": null,
    "attemptCount": null,
    "createdAt": "2027-01-15T15:53:20",
    "updatedAt": "2027-01-15T15:55:01",
    "requestId": "..."
  }
}

An ARRANGEMENT job reaching READY means the arrangement is complete, not that a song can be downloaded. Downloading requires projectStatus = READY with a usable readyAsset.

​

Common errors

• code = 47009: the job does not exist or does not belong to your account.
• code = 47011: temporarily unavailable — retry with backoff.