Regenerate the arrangement

Ask the service for a new arrangement for the current brief.

POST /sound_clone/api/v1/music/projects/{projectId}/arrangement/regenerate

curl --location 'https://api.myvocal.ai/sound_clone/api/v1/music/projects/mup_.../arrangement/regenerate' \
--header 'accessKey: <your_api_key>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: 91b7c0de4a2f57c3' \
--data '{ "expectedVersion": 1 }'

200 Success

{
  "code": 1,
  "message": "success",
  "data": {
    "projectId": "mup_...",
    "jobId": "muj_...",
    "jobType": "ARRANGEMENT",
    "status": "QUEUED",
    "requestId": "..."
  }
}

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

Queues a new ARRANGEMENT job for the project’s current brief. Use this when you would rather get a fresh arrangement than edit the existing one.

​

Header

accessKey · string · required

Your API key. See Authentication.

Idempotency-Key · string · required

Unique per operation: 16–64 printable ASCII characters. Same key with a different body is rejected with 47008.

​

Path

projectId · string · required

The project identifier.

​

Body

expectedVersion · number · required

The arrangementVersion you based this request on. A mismatch is rejected with 47016.

​

Response

projectId · string

Project identifier.

jobId · string

The new arrangement job.

jobType · string

ARRANGEMENT.

status · string

QUEUED.

curl --location 'https://api.myvocal.ai/sound_clone/api/v1/music/projects/mup_.../arrangement/regenerate' \
--header 'accessKey: <your_api_key>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: 91b7c0de4a2f57c3' \
--data '{ "expectedVersion": 1 }'

200 Success

{
  "code": 1,
  "message": "success",
  "data": {
    "projectId": "mup_...",
    "jobId": "muj_...",
    "jobType": "ARRANGEMENT",
    "status": "QUEUED",
    "requestId": "..."
  }
}

A replay re-reads the job instead of replaying the first response byte-for-byte: the same key can return the job read model, with a different field set and a later status. Use jobId to query the job.

​

Common errors

• code = 47016: expectedVersion does not match. Re-read the project and retry.
• code = 47008: the Idempotency-Key was reused with a different body.
• code = 47009: the project does not exist or is not owned by your account.
• code = 47010: another operation is already in progress for this project.