curl --location 'https://api.myvocal.ai/sound_clone/api/v1/music/capabilities' \
--header 'accessKey: <your_api_key>'
{
"code": 1,
"message": "success",
"data": {
"accessState": "ENABLED",
"planKey": "PRO",
"ratePerMinute": 1920,
"rateVersion": "music-2026-08-26-v1",
"balances": { "monthly": "10500", "additional": "0", "total": "10500" },
"quoteTtlSeconds": 600,
"supportedDurationsSec": [60, 90, 120, 180],
"supportedVocalLanguages": [ { "code": "en", "name": "English" } ],
"genres": ["POP", "ROCK", "HIP_HOP", "ELECTRONIC", "RNB_SOUL", "INDIE", "JAZZ", "CINEMATIC", "FOLK_ACOUSTIC", "LATIN", "COUNTRY", "CLASSICAL"],
"moods": ["UPLIFTING", "ENERGETIC", "ROMANTIC", "DREAMY", "MELANCHOLIC", "DARK", "CALM", "HOPEFUL", "DRAMATIC", "PLAYFUL", "NOSTALGIC", "INTENSE"],
"vocalStyles": ["WARM_INTIMATE", "BRIGHT_ENERGETIC", "POWERFUL_ANTHEMIC", "SOFT_BREATHY"],
"lyricsModes": ["AUTO", "CUSTOM"],
"requestId": "..."
}
}
Music API reference
Music capabilities
Read the Text-to-Music account state, rate card and accepted enum values.
GET
/
sound_clone
/
api
/
v1
/
music
/
capabilities
curl --location 'https://api.myvocal.ai/sound_clone/api/v1/music/capabilities' \
--header 'accessKey: <your_api_key>'
{
"code": 1,
"message": "success",
"data": {
"accessState": "ENABLED",
"planKey": "PRO",
"ratePerMinute": 1920,
"rateVersion": "music-2026-08-26-v1",
"balances": { "monthly": "10500", "additional": "0", "total": "10500" },
"quoteTtlSeconds": 600,
"supportedDurationsSec": [60, 90, 120, 180],
"supportedVocalLanguages": [ { "code": "en", "name": "English" } ],
"genres": ["POP", "ROCK", "HIP_HOP", "ELECTRONIC", "RNB_SOUL", "INDIE", "JAZZ", "CINEMATIC", "FOLK_ACOUSTIC", "LATIN", "COUNTRY", "CLASSICAL"],
"moods": ["UPLIFTING", "ENERGETIC", "ROMANTIC", "DREAMY", "MELANCHOLIC", "DARK", "CALM", "HOPEFUL", "DRAMATIC", "PLAYFUL", "NOSTALGIC", "INTENSE"],
"vocalStyles": ["WARM_INTIMATE", "BRIGHT_ENERGETIC", "POWERFUL_ANTHEMIC", "SOFT_BREATHY"],
"lyricsModes": ["AUTO", "CUSTOM"],
"requestId": "..."
}
}
Text to Music · Workflow: Text-to-Music quickstart · Polling: Async jobs and retries
Read this endpoint first. It tells you what the account may do and which enum values the write endpoints accept, so you never have to hard-code them.
Header
Your API key. See Authentication.
Response
Whether this account may use Text-to-Music:
ENABLED or DISABLED. DISABLED means generation is not available for the account.Accepted
genre values: POP, ROCK, HIP_HOP, ELECTRONIC, RNB_SOUL, INDIE, JAZZ, CINEMATIC, FOLK_ACOUSTIC, LATIN, COUNTRY, CLASSICAL.Accepted
moods values: UPLIFTING, ENERGETIC, ROMANTIC, DREAMY, MELANCHOLIC, DARK, CALM, HOPEFUL, DRAMATIC, PLAYFUL, NOSTALGIC, INTENSE.curl --location 'https://api.myvocal.ai/sound_clone/api/v1/music/capabilities' \
--header 'accessKey: <your_api_key>'
{
"code": 1,
"message": "success",
"data": {
"accessState": "ENABLED",
"planKey": "PRO",
"ratePerMinute": 1920,
"rateVersion": "music-2026-08-26-v1",
"balances": { "monthly": "10500", "additional": "0", "total": "10500" },
"quoteTtlSeconds": 600,
"supportedDurationsSec": [60, 90, 120, 180],
"supportedVocalLanguages": [ { "code": "en", "name": "English" } ],
"genres": ["POP", "ROCK", "HIP_HOP", "ELECTRONIC", "RNB_SOUL", "INDIE", "JAZZ", "CINEMATIC", "FOLK_ACOUSTIC", "LATIN", "COUNTRY", "CLASSICAL"],
"moods": ["UPLIFTING", "ENERGETIC", "ROMANTIC", "DREAMY", "MELANCHOLIC", "DARK", "CALM", "HOPEFUL", "DRAMATIC", "PLAYFUL", "NOSTALGIC", "INTENSE"],
"vocalStyles": ["WARM_INTIMATE", "BRIGHT_ENERGETIC", "POWERFUL_ANTHEMIC", "SOFT_BREATHY"],
"lyricsModes": ["AUTO", "CUSTOM"],
"requestId": "..."
}
}
Common errors
code = 401,"Key verification failed": theaccessKeyis missing, invalid or disabled. This is returned with HTTP200and nodatafield.code = 47018: Text-to-Music is not available for this account or cohort.