curl --location 'https://api.myvocal.ai/sound_clone/api/v1/interpretation/capabilities' \
--header 'accessKey: <your_api_key>'
{
"code": 1,
"message": "success",
"data": {
"productName": "Interpretation",
"rateVersion": "interp-2026-09-27-v1",
"languageCatalogVersion": "1",
"languageCatalogState": "CONFIGURED",
"formatCatalogVersion": "1",
"languages": [ { "languageKey": "es", "displayName": "Spanish", "sourceSupport": "UNVERIFIED" }, { "languageKey": "fr", "displayName": "French", "sourceSupport": "UNVERIFIED" } ],
"audioFormats": ["mp3", "wav", "m4a", "aac", "flac", "aiff", "ogg", "oga", "opus", "weba"],
"videoFormats": ["mp4", "mov", "m4v", "mkv", "avi", "webm", "wmv", "mpeg", "mpg", "3gpp"],
"exportFormats": ["mp3", "wav", "flac", "mp4"],
"maxSourceBytes": "3221225472",
"planRates": [ { "planKey": "PRO", "charactersPerMinutePerLanguage": 4000 } ],
"quoteTtlSeconds": 600,
"account": {
"planKey": "PRO",
"accessState": "ENABLED",
"entitlementVersion": "1",
"charactersPerMinutePerLanguage": 4000,
"availableCharacters": "10500",
"balanceState": "AVAILABLE"
},
"stageAvailability": { "project": "AVAILABLE", "upload": "AVAILABLE", "export": "AVAILABLE" },
"requestId": "..."
}
}
Interpretation API reference
Interpretation capabilities
Read the Interpretation account state, rate, language catalog and supported formats.
GET
/
sound_clone
/
api
/
v1
/
interpretation
/
capabilities
curl --location 'https://api.myvocal.ai/sound_clone/api/v1/interpretation/capabilities' \
--header 'accessKey: <your_api_key>'
{
"code": 1,
"message": "success",
"data": {
"productName": "Interpretation",
"rateVersion": "interp-2026-09-27-v1",
"languageCatalogVersion": "1",
"languageCatalogState": "CONFIGURED",
"formatCatalogVersion": "1",
"languages": [ { "languageKey": "es", "displayName": "Spanish", "sourceSupport": "UNVERIFIED" }, { "languageKey": "fr", "displayName": "French", "sourceSupport": "UNVERIFIED" } ],
"audioFormats": ["mp3", "wav", "m4a", "aac", "flac", "aiff", "ogg", "oga", "opus", "weba"],
"videoFormats": ["mp4", "mov", "m4v", "mkv", "avi", "webm", "wmv", "mpeg", "mpg", "3gpp"],
"exportFormats": ["mp3", "wav", "flac", "mp4"],
"maxSourceBytes": "3221225472",
"planRates": [ { "planKey": "PRO", "charactersPerMinutePerLanguage": 4000 } ],
"quoteTtlSeconds": 600,
"account": {
"planKey": "PRO",
"accessState": "ENABLED",
"entitlementVersion": "1",
"charactersPerMinutePerLanguage": 4000,
"availableCharacters": "10500",
"balanceState": "AVAILABLE"
},
"stageAvailability": { "project": "AVAILABLE", "upload": "AVAILABLE", "export": "AVAILABLE" },
"requestId": "..."
}
}
Interpretation · Translate and dub uploaded audio/video · Workflow: Interpretation quickstart · Polling: Async jobs and retries
Read this endpoint first. It publishes the language keys you may request, the accepted input formats, the export formats and the account’s rate — instead of hard-coding any of them.
Header
Your API key. See Authentication.
Response
CONFIGURED when an authoritative language list is configured; EMPTY when no usable entries exist, in which case quoting is not available.The language entries:
{ languageKey, displayName, sourceSupport }. Use languageKey as targetLanguages and sourceLanguage.{ planKey, accessState, entitlementVersion, charactersPerMinutePerLanguage, availableCharacters, balanceState }. availableCharacters is a string or null.accessStateis one ofENABLED,FREE_LOCKED,ENTERPRISE_UNRESOLVED,SYNCINGorUNRESOLVED. OnlyENABLEDmay generate.balanceStateis eitherAVAILABLEorLEDGER_UNAVAILABLE, and it describes this account field only. When the shared ledger read is unavailable,availableCharactersisnullandbalanceStateisLEDGER_UNAVAILABLEinstead of a guessed number.
Availability flags for the public stages. Internal development identifiers are not published here.
curl --location 'https://api.myvocal.ai/sound_clone/api/v1/interpretation/capabilities' \
--header 'accessKey: <your_api_key>'
{
"code": 1,
"message": "success",
"data": {
"productName": "Interpretation",
"rateVersion": "interp-2026-09-27-v1",
"languageCatalogVersion": "1",
"languageCatalogState": "CONFIGURED",
"formatCatalogVersion": "1",
"languages": [ { "languageKey": "es", "displayName": "Spanish", "sourceSupport": "UNVERIFIED" }, { "languageKey": "fr", "displayName": "French", "sourceSupport": "UNVERIFIED" } ],
"audioFormats": ["mp3", "wav", "m4a", "aac", "flac", "aiff", "ogg", "oga", "opus", "weba"],
"videoFormats": ["mp4", "mov", "m4v", "mkv", "avi", "webm", "wmv", "mpeg", "mpg", "3gpp"],
"exportFormats": ["mp3", "wav", "flac", "mp4"],
"maxSourceBytes": "3221225472",
"planRates": [ { "planKey": "PRO", "charactersPerMinutePerLanguage": 4000 } ],
"quoteTtlSeconds": 600,
"account": {
"planKey": "PRO",
"accessState": "ENABLED",
"entitlementVersion": "1",
"charactersPerMinutePerLanguage": 4000,
"availableCharacters": "10500",
"balanceState": "AVAILABLE"
},
"stageAvailability": { "project": "AVAILABLE", "upload": "AVAILABLE", "export": "AVAILABLE" },
"requestId": "..."
}
}
Common errors
code = 401,"Key verification failed": theaccessKeyis missing, invalid or disabled. Returned with HTTP200and nodata.code = 47128: the account’s plan is not entitled to generate (for exampleFREE).code = 47119: an ENTERPRISE account has no configured contract rate. Interpretation does not fall back to a default rate.