curl --location 'https://api.myvocal.ai/sound_clone/api/v1/music/projects' \
--header 'accessKey: <your_api_key>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: 6f1c1f0e0b8a4d1e' \
--data '{
"description": "An upbeat summer pop song about a road trip along the coast.",
"genre": "POP",
"styleNotes": "Bright synths, driving drums, warm bass.",
"moods": ["UPLIFTING", "ENERGETIC"],
"vocalLanguage": "en",
"durationSec": 90,
"lyricsMode": "AUTO",
"vocalStyle": "BRIGHT_ENERGETIC"
}'
{
"code": 1,
"message": "success",
"data": {
"projectId": "mup_...",
"projectStatus": "ARRANGEMENT_GENERATING",
"job": { "jobId": "muj_...", "jobType": "ARRANGEMENT", "status": "QUEUED" },
"requestId": "..."
}
}
{
"code": 1,
"message": "success",
"data": {
"projectId": "mup_...",
"name": "Coast Road",
"projectStatus": "ARRANGEMENT_READY",
"arrangementVersion": 1,
"arrangement": { "...": "..." },
"activeJob": { "jobId": "muj_...", "status": "READY" },
"requestId": "..."
}
}
Create and generate
Create a music project
Start a Text-to-Music project from a creative brief. Returns the project and its arrangement job.
POST
/
sound_clone
/
api
/
v1
/
music
/
projects
curl --location 'https://api.myvocal.ai/sound_clone/api/v1/music/projects' \
--header 'accessKey: <your_api_key>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: 6f1c1f0e0b8a4d1e' \
--data '{
"description": "An upbeat summer pop song about a road trip along the coast.",
"genre": "POP",
"styleNotes": "Bright synths, driving drums, warm bass.",
"moods": ["UPLIFTING", "ENERGETIC"],
"vocalLanguage": "en",
"durationSec": 90,
"lyricsMode": "AUTO",
"vocalStyle": "BRIGHT_ENERGETIC"
}'
{
"code": 1,
"message": "success",
"data": {
"projectId": "mup_...",
"projectStatus": "ARRANGEMENT_GENERATING",
"job": { "jobId": "muj_...", "jobType": "ARRANGEMENT", "status": "QUEUED" },
"requestId": "..."
}
}
{
"code": 1,
"message": "success",
"data": {
"projectId": "mup_...",
"name": "Coast Road",
"projectStatus": "ARRANGEMENT_READY",
"arrangementVersion": 1,
"arrangement": { "...": "..." },
"activeJob": { "jobId": "muj_...", "status": "READY" },
"requestId": "..."
}
}
Text to Music · Workflow: Text-to-Music quickstart · Polling: Async jobs and retries
Creates the project and immediately queues the arrangement stage. This is asynchronous: the response does not contain a song.
Header
Your API key. See Authentication.
Unique per distinct operation: 16–64 printable ASCII characters. Same key with the same body replays safely; same key with a different body is rejected with
47008.Body
Required content only with
lyricsMode: "CUSTOM" (20–2800 code points). Normalized to null under AUTO.Response
curl --location 'https://api.myvocal.ai/sound_clone/api/v1/music/projects' \
--header 'accessKey: <your_api_key>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: 6f1c1f0e0b8a4d1e' \
--data '{
"description": "An upbeat summer pop song about a road trip along the coast.",
"genre": "POP",
"styleNotes": "Bright synths, driving drums, warm bass.",
"moods": ["UPLIFTING", "ENERGETIC"],
"vocalLanguage": "en",
"durationSec": 90,
"lyricsMode": "AUTO",
"vocalStyle": "BRIGHT_ENERGETIC"
}'
{
"code": 1,
"message": "success",
"data": {
"projectId": "mup_...",
"projectStatus": "ARRANGEMENT_GENERATING",
"job": { "jobId": "muj_...", "jobType": "ARRANGEMENT", "status": "QUEUED" },
"requestId": "..."
}
}
{
"code": 1,
"message": "success",
"data": {
"projectId": "mup_...",
"name": "Coast Road",
"projectStatus": "ARRANGEMENT_READY",
"arrangementVersion": 1,
"arrangement": { "...": "..." },
"activeJob": { "jobId": "muj_...", "status": "READY" },
"requestId": "..."
}
}
A replay is not the first response replayed byte-for-byte: it re-reads the current project and may return the full project detail instead. Use
projectId to query the resource.Common errors
code = 47001: the brief failed validation (unknown enum, wrong duration, mood list empty or duplicated, description out of range).code = 47008: theIdempotency-Keywas reused with a different body.code = 47011: temporarily unavailable — retry with backoff.code = 47018: Text-to-Music is not available for this account or cohort.